Buy Now | Ask a Question

Mapping Azure AD (Entra ID) Users with Jira Users and Jira Groups

Owned by Pio
Last updated: Oct 25, 2024
8 min read

The Assets module of JSM provides amazing features. Two of the useful capabilities are being able to define attributes as a “Jira User” type and/or “Jira Group”. Even though they are not a part of the external import flow used by our applications, on this page, we will explore the ways to leverage these.

The example use case could be as follows:

Use Case:

As an Asset and Configuration Manager, I would like to keep track of all the Microsoft Entra ID (a.k.a. Azure AD) User records and extend them by adding their Jira User and Jira Groups information.

 

The same use case is valid for our other applications that store user-related information, including Okta, Google Workspace, Intune, Jamf, Snipe-IT, Salesforce, Hubspot, Database, etc. We will provide 2 different methods to map Entra ID (Azure AD) users with Jira Users and Jira Groups in JSM Assets as an example. You may apply the same logic for other data sources you may have.

This would be very handy if you configured Atlassian Guard (a.k.a. Atlassian Access) and already have sync configuration for the Users and Groups from your IDP.

Prerequisite: Atlassian Guard (Atlassian Access) subscription connected to your identity provider (IDP).

Benefits

One of the benefits of having the Jira User as an attribute of the Users (or other object types) would be using the Filter Issue Scope AQL of an Assets Custom Field to allow the requestor to view the records mapped for their user. Here are some examples:

Case

Filter Issue Scope AQL to be used

Example Object Types

Case

Filter Issue Scope AQL to be used

Example Object Types

You have an object schema where you have Users or People as Object Type having a “Jira User” attribute.

"Jira User" = currentReporter()

Azure AD (Entra ID) Users

Okta People

Google Workspace Users

Salesforce Contact Person

Hubspot Contact

Intune Users

Jamf Users

Snipe-IT Users

Datadog Contacts

Tempo Jira Users

You have an object type that stores device related information (for example Intune “Managed Devices”) and has an attribute called “Owner” related to the “Users” object type which has “Jira User” attribute.

"Owner"."Jira User" = currentReporter()

Intune Managed Devices

Jamf Computers, Mobile Devices

Google Workspace Mobile Devices, Chrome OS Devices

Snipe-IT Assets

Okta Devices

Datadog Services

 

 

 Instructions

 

The following are just 2 possible examples to fulfill the use case.

You may follow different paths depending on your needs:

 

  • Start with Option 1 and then continue with one of the following

    • Scenario 1

    • Scenario 2

  • Start with Option 2 and then continue with one of the following

    • Scenario 1

    • Scenario 2

 

Option 1:

Update objects instantly when they are created or updated and set the Jira User and/or Jira Groups.

  1. Install Azure AD (Microsoft Entra ID) Importer for JSM Assets from the marketplace.

  2. Watch the demo.

  3. Configure and import your organizational data (i.e. Users and Managers)

  4. Set the scheduling for automated replication.

  5. Select your “Azure AD” object schema and “Users” object type. Select “Attributes”.

  6. Add one new attribute to the end and name it as “Jira User”. Set the type to “User”.

  7. [Optional. Needed for Scenario 2] Add another attribute for “Jira Groups” and set the type to “Groups”. Edit the attribute properties and set the cardinality as unlimited.

  8. Add one more attribute to the end, and name it “Previous E-mail Address”. You will use this attribute to understand when a user's email address changes.

  9. Add the last attribute and call it “E-mail Check Date“ to store the date information when the automation rule runs.

Azure AD Schema.png

  1. Create an automation rule at the Global level with the following steps.

Automation Component

Configuration

Explanation

Automation Component

Configuration

Explanation

Screenshot 2024-10-25 at 11.57.52.png

 

 

Select the trigger for Object Trigger and click “Created“ tab. Select “Azure AD” object schema.

 

 

Check if the updated object is one of Users and has an email address.

objecttype = Users and "E-mail Address" is not empty

Search for the user’s “Jira User” record using the Jira Rest API and get the accountId.

Send a GET web request to Jira API using the URL:

https://your-site-name.atlassian.net/rest/api/2/user/search?query={{object."E-mail Address"}}

Add a header called Authorization. Enable the Hidden checkbox. The hidden part in the header needs to be in a format like:

Basic Y29udGFwgpxwaW8uc29mdHdhcyyyyWxNZmh4SVdUeFU1YWtwSHJDljI5xxxx

 

Please note that your Email Address and API Token need to be Base64 encoded, as explained in the following document.

Basic auth for REST APIs

 

Make sure that you found only one record.

Check {{webResponse.body.size}}

We recommend using the “Log Action” component between the steps above to see if you have mapped the fields properly and the data is flowing as expected. This will save time while you are troubleshooting your rule.

Pros:

Updates objects as soon as they are created in Assets.

Cons:

The trigger is set for “Object Created” event only as an example. You need to cover the updated objects too.

If you have a very large user base and thousands of user creations or updates occur daily, this trigger may hit the Jira Cloud automation limits and fail. Option 2 below could be a better solution in that case.

Automation Component

Configuration

Explanation

Automation Component

Configuration

Explanation

 

Select the trigger for Object Trigger and click “Updated“ tab. Select “Azure AD” object schema.

 

Check if the updated object is one of Users and has an email address.

objecttype = Users and "E-mail Address" is not empty

 

 

 

 

 

 

Add an If block to check at least one condition matches:

Condition 1: {{smart values}} condition

{{object."E-mail Address"}}

does not equal

{{object."Previous E-mail Address"}}

This means the email address of the user has changed recently.

Condition 2: AQL condition

"Jira User" is empty

This means the user record doesn’t have a “Jira User” mapped yet.

Search for the user’s “Jira User” record using the Jira Rest API and get the accountId.

Send a GET web request to Jira API using the URL:

https://your-site-name.atlassian.net/rest/api/2/user/search?query={{object."E-mail Address"}}

Add a header called Authorization. Enable the Hidden checkbox. The hidden part in the header needs to be in a format like:

Basic Y29udGFwgpxwaW8uc29mdHdhcyyyyWxNZmh4SVdUeFU1YWtwSHJDljI5xxxx

 

Please note that your Email Address and API Token need to be Base64 encoded, as explained in the following document.

Basic auth for REST APIs

 

Make sure that you found only one record.

Check {{webResponse.body.size}}

 

  1. If you successfully came to this step, you should have 2 automation rules ready to run on Object Created and Object Updated conditions. From this point, please follow Scenario 1 or Scenario 2, described at the bottom of this page, to complete your automation rules. Don’t forget to do the same for 2 rules.

 

Option 2:

  1. If you have a scheduled Azure AD import configuration in your Azure AD Importer for JSM Assets application then there is a chance that the Jira User is not created at the time of Azure AD import. Another case can be that high number of records are being updated and it is not feasible to use Option 1. In such cases, this requires the mapping to be performed not in real-time but periodically (i.e. hourly or daily).

  2. Follow the same steps as Option 1 above until Step 10.

  3. Create an automation rule at the Global level.

Automation Component

Configuration

Explanation

Automation Component

Configuration

Explanation

 

 

Decide on the best scheduling frequency for your environment. If you have few users, then once a day (i.e., every night at 03:00 AM) could be sufficient. On the other hand, if you have thousands of records, then you need to check more frequently (i.e., every 30 minutes). You will find the best schedule configuration after you try the rule several times.

There will be two branches in this automation. Here is Branch 1:

 

Find the Users in the “Azure AD” object schema which don’t have the Jira User defined Use the AQL:

objecttype = Users and "Jira User" is empty and "E-mail Address" is not empty

 

 

Search for the user’s “Jira User” record using the Jira Rest API and get the accountId.

Send a GET web request to Jira API using the URL:

https://your-site-name.atlassian.net/rest/api/2/user/search?query={{object."E-mail Address"}}

Add a header called Authorization. Enable the Hidden checkbox. The hidden part in the header needs to be in a format like:

Basic Y29udGFwgpxwaW8uc29mdHdhcyyyyWxNZmh4SVdUeFU1YWtwSHJDljI5xxxx

 

Please note that your Email Address and API Token need to be Base64 encoded, as explained in the following document.

Basic auth for REST APIs

 

Make sure that you found only one record.

Check {{webResponse.body.size}}

Here is Branch 2:

 

 

 

 

Find the Users in the “Azure AD” object schema which are updated by the automation rule more than 1 day ago. Use the AQL:

objecttype = Users and "Previous E-mail Address" is not empty and ("E-mail Check Date" < {{now.minusDays(1)}} or "E-mail Check Date" is empty)

 

 

Search for the user’s “Jira User” record using the Jira Rest API and get the accountId.

Send a GET web request to Jira API using the URL:

https://your-site-name.atlassian.net/rest/api/2/user/search?query={{object."E-mail Address"}}

Add a header called Authorization. Enable the Hidden checkbox. The hidden part in the header needs to be in a format like:

Basic Y29udGFwgpxwaW8uc29mdHdhcyyyyWxNZmh4SVdUeFU1YWtwSHJDljI5xxxx

 

Please note that your Email Address and API Token need to be Base64 encoded, as explained in the following document.

Basic auth for REST APIs

 

Make sure that you found only one record.

Check {{webResponse.body.size}}

  1. Now, your rule should look like the following:

  1. From this point, please follow Scenario 1 or Scenario 2, described at the bottom of this page, to complete your automation rules.

 

 

Pros:

Updates objects periodically.

Cons:

Updates 50 records in every execution. If you have a very large user base, it could take some time for all the objects to be updated.

 

Scenario 1

Add the following step after each smart value comparison step checking {{webResponse.body.size}}in your rule(s).

Automation Component

Configuration

Explanation

Automation Component

Configuration

Explanation

 

 

Edit the object

1- Set the Jira User attribute using the Smart Value:

{{webResponse.body.accountId}}

2- Set the Previous E-mail Address.

{{object."E-mail Address"}}

3- Set the E-mail Check Date:

{{now}}

Scenario 2

Automation Component

Configuration

Explanation

Automation Component

Configuration

Explanation

 

Create a variable as jiraUserAccountId for {{webResponse.body.accountId}}

 

 

Send a GET web request to the following URL: https://your-site-name.atlassian.net/rest/api/3/user/groups?accountId={{jiraUserAccountId}}

This request collects the list of Jira Groups for the user from Jira Cloud platform.

 

 

Make sure that the response has the information needed by checking {{webResponse.body.size}} is greater than 0.

 

Collect all the Jira Groups in to a variable called jiraGroups by using the smart value {{webResponse.body.name.asJsonObject("value").asJsonArray}}

 

 

To be able to update the object, first, you need to find the Workspace ID for your Assets environment by sending a GET web request to https://asset-importers.atlassian.net/rest/servicedeskapi/assets/workspace

Create a variable as workspaceId

for the {{webResponse.body.values.workspaceId}} smart value.

Not a step in the automation

 

Check the Object Type configuration for your Users object type and get the ID. In the screenshot, you will see that it is 133 for our demo site.

 

Not a step in the automation

Take note of the object type attributes for the new attributes you created. You may copy them from the attribute view by clicking the copy icon on the right.

 

Add a new step to update the Object. Send a PUT command this time to the URL: https://api.atlassian.com/jsm/assets/workspace/{{workspaceId}}/v1/object/{{object.id}}

Select the web request body as “Custom data“ and copy paste the following JSON. Update the object type ID and attribute IDs accordingly.

{ "attributes": [ { "objectTypeAttributeId": "3555", "objectAttributeValues": [ { "value": "{{jiraUserAccountId}}" } ] }, { "objectTypeAttributeId": "3558", "objectAttributeValues": {{jiraGroups}} }, { "objectTypeAttributeId": "3981", "objectAttributeValues": "{{object."E-mail Address"}}" }, { "objectTypeAttributeId": "4029", "objectAttributeValues": "{{now"}}" } ], "objectTypeId": "133" }

 

 

 

Add the response status code to the Audit log as {{webResponse.status}}

You should see “200” in the logs if everything is fine.

 

 

Buy Now | Ask a Question