Connect AptEdge to Jira Cloud

This guide explains how to create a Jira OAuth integration and connect it to your AptEdge instance.

Prerequisites:

1. We recommend creating an integration user in Atlassian for this connection (It can be the same account used for Confluence)

2. Ensure the user has access to all Jira projects that should be indexed in AptEdge.

3. The account only requires read permissions.

The following steps should be performed with the integration user.

Step 1: Create a Jira OAuth Integration

1. Navigate to the Atlassian Developer Console:

   https://developer.atlassian.com/console/myapps

2. Click Create.

3. From the dropdown menu, select OAuth 2.0 Integration.

4. Enter a name for the integration, for example:

   AptEdge Jira Integration

5. Click Create.

Step 2: Configure Jira Permissions

1. In the left-hand navigation menu, select Permissions.

2. Click Add next to Jira API.

3. Select Configure.

4. Under Classic Scopes -J ira platform REST API, click Edit Scopes.

5. Enable the following permissions:

• View Jira issue data (read:jira-work)

• View user profiles (read:jira-user)

6. Click Save.

Step 3: Configure OAuth Authorization

1. In the left-hand navigation menu, select Authorization.

2. Click Add under OAuth 2.0.

3. Enter the callback URL for your AptEdge instance:

   1. For example, if your aptedge instance is https://acme.aptedge.io, enter

   2. https://acme.aptedge.io/jira/callback

4. Click Save changes.

Step 4: Retrieve the OAuth Credentials

1. Open the Settings page of your OAuth integration.

2. Copy the following values:

• Client ID

• Client Secret

You will need these values to connect Jira to AptEdge.

Step 5: Connect Jira to AptEdge

1. Log in to your AptEdge instance as an administrator.

2. Click the gear icon in the top navigation.

3. Select:

Admin Settings → Integrations

4. Find Jira Cloud.

5. Click Connect.

6. Enter the following information:

   OAuth Client ID
   (from Step 4)

   OAuth Client Secret
   (from Step 4)

   Jira Base URL

   Example:

   https://yourcompany.atlassian.net

7. Click Authorize.