Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Jira Connection Configuration

...

Info

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

1-

  1. Create a Jira Admin User

...

  1. to be used in the application (e.

...

  1. g. jira_bot@example.com)

...

  1. Ensure the user has a JSM Agent License

...

  1. .

...

  1. Login with the bot user and create an API Token

...

  1. (How to…)

Info

In case If the user is an external user then you need to enable API access for the external user first. You may find the related Atlassian Documentation belowexternal, API access must be enabled first. Refer to Atlassian’s documentation:

https://support.atlassian.com/security-and-access-policies/docs/set-api-token-access/

...

  1. Enter the User Email (e.g. jira_bot@example.com)

...

  1. and Jira

...

  1. API Token

...

  1. in the Jira Connection Settings.

...

  1. The Jira Service Management Site Name is the first part of your Jira Cloud

...

  1. URL.

...

...

  • , enter

...

  • "site-name"

...

  • .

...

  1. Click

...

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

image-20250210-104434.pngImage Added

Info

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.

https://piosoftware.atlassian.net/wiki/spaces/WS/pages/1277953/FAQ#Security

Schema Selection Configuration

You have 2 two options in this section. You may create :

  1. Create a new Object Schema

...

  1. Use an existing

...

  1. Object Schema

Info

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. For example:

  • Object Schema Name: Azure AD

  • Object

...

  • Schema Key: AD

  • Description: Auto-generated Azure AD data

...

and click the buttonThen, click "Create Object Schema" to proceed.

Image Removed

image-20250210-110032.pngImage Added

Option 2: Use an Existing Object Schema

  1. Select an

...

  1. Existing Object Schema.

  2. Click "Use Existing Object Schema" to continue.

Note

In case you already have If the selected schema already contains the same Object Types in your existing schema, we you will inform you and expect them to be updated be notified and required to update them before moving forward.

Info

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.

Object Schema Roles.pngImage Modified

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

Import Token Configuration

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

  1. Click on the Go to Schema Import

...

  1. Page link and configure the import configuration. (You may find it in the Schema Selection Configuration section.)

...

image-20250210-111805.pngImage Added

  1. Navigate to the "Import" tab and click "Create Import" to begin the setup.

...

  1. Select "External Import" and click

...

  1. "Next".

...

  1. Enter the Name and Description fields.

...

  1. Click

...

  1. the three dots (…) and select

...

  1. "Generate new

...

  1. token".

...

  1. Copy the generated token.

...

  1. Paste the token

...

  1. into the Import Token field in Import Token Configuration

...

  1. , then click

...

  1. "Save Import Token".

image-20250210-112357.pngImage Added

  1. Now, it is time to import.