Destination

Jira Connection Configuration

Our application leverages Jira Rest API for programmatic access while updating Object Schema, Object Type, and Attribute configurations of JSM Assets.

You need help from a Jira Administator for the steps on this page.

Create a Jira Admin User to be used in the application (e.g. jira_bot@example.com)
Ensure the user has a JSM Agent License.
Login with the bot user and create an API Token (How to…)

If the user is external, API access must be enabled first. Refer to Atlassian’s documentation:

Block user API token access | Atlassian Support

Enter the User Email (e.g. jira_bot@example.com) and Jira API Token in the Jira Connection Settings.
The Jira Service Management Site Name is the first part of your Jira Cloud URL.

Example: If your base URL is https://site-name.atlassian.net, enter "site-name".

Click "Save & Check Connection" to verify the setup.

Troubleshooting Connection Issues

If you don’t receive a success message, check the following:

User Permissions: Ensure the user is a Jira Admin and has a JSM User license.
Site Allow List: If an IP allow list is enabled, add the Forge IP addresses to grant access to your site through our application.

FAQ | Security

Schema Selection Configuration

You have two options in this section:

Create a new Object Schema
Use an existing Object Schema

Pro Tip:

We recommend creating a new Object Schema to store Azure AD-related data separately. This allows you to assign roles only to necessary users or groups. Since the imported data includes personal information, ensure compliance with your organization’s data policies.

Option 1: Create a New Object Schema

Fill in the following fields:

Object Schema Name: Azure AD
Object Schema Key: AD
Description: Auto-generated Azure AD data

Then, click "Create Object Schema" to proceed.

Option 2: Use an Existing Object Schema

Select an Existing Object Schema.
Click "Use Existing Object Schema" to continue.

If the selected schema already contains the same Object Types, you will be notified and required to update them before moving forward.

Pro tip: Either you chose Option 1 or 2, make sure that you remove the default values from the Object Schema Roles menu. It should look like the following.

Then, only add the relevant users, groups, or apps.

Import Token Configuration

To import a large amount of data into JSM Assets, you need to generate a key that securely authorizes the data transfer (more info).
Please add the Import Token for your External Import configuration in Assets.

Click on the Go to Schema Import Page link and configure the import configuration. (You may find it in the Schema Selection Configuration section.)