Jira Cloud Platform

Jira Cloud platform provides a set of base functionality shared across all Jira products, such as issues, users, assets, and more. Jira products are built on top of the Jira Cloud platform. Currently, Lucidum supports users and assets connectors.

Creating an API Key for Jira #

Before configuring the Jira connector in Lucidum, you must first create an API Key. Lucidum will use the API key to access the Jira API.

To integrate Lucidum with Jira, you need to do the following :

1. Create a user in your Atlassian site with access to Jira. This user must have global Jira administrators permission. For details, see https://confluence.atlassian.com/adminjiraserver/managing-global-permissions-938847142.html

2. Log in to Jira using the created user and generate an API token. For cloud-based Atlassian sites, use the following URL to generate an API token: https://id.atlassian.com/manage/api-tokens#

Configuring the Connector for Jira #

To configure Lucidum to ingest data from Jira:

1. Log in to Lucidum.

2. In the left pane, click Connector.

3. In the Connector page, click Add Connector.

4. Scroll until you find the Connector you want to configure. Click Connect. The Settings page appears.

5. In the Settings page, enter the following:

   • URL (required). The base URL of the Jira Cloud Platform REST API. For example, https://lucidum.atlassian.net.

   • User Name. User name for a Jira account that has global Jira administrators permission.

     NOTE: This user must have global Jira administrators permission. For details, see https://confluence.atlassian.com/adminjiraserver/managing-global-permissions-938847142.html

     NOTE: If your organization requires more granular permissions, please contact your Lucidum Customer Success representative to help you with the required Jira permission.

   • API Token. An API Token associated with the user account specified in User Name.

     NOTE: Jira provides both an API Key and an API Token. Lucidum uses only the API Token.

6. To test the configuration, click Test.

   • If the connector is configured correctly, Lucidum displays a list of services that are accessible with the connector.

   • If the connector is not configured correctly, Lucidum displays an error message.

API Documentation #

https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-users/#api-group-users

https://developer.atlassian.com/cloud/assetsapi/rest/api-group-assets/#api-asset-get

https://developer.atlassian.com/cloud/assets/assets-rest-api-guide/workflow/#assets-rest-api-guide