Jira OAuth Integration Guide

This guide explains how to set up an Atlassian OAuth 2.0 (3LO) integration for AINexLayer to connect your Jira projects.

Step 1: Accessing the Developer Console

1. Navigate to developer.atlassian.com
2. Click your profile icon in the top-right corner
3. Select "Developer console" from the dropdown

Step 2: Creating a New OAuth 2.0 Integration

1. In the Developer Console, under My apps, click the "Create" button
2. Select "OAuth 2.0 integration" from the dropdown

Step 3: Naming Your Integration

1. Enter Name: AINexLayer
2. Check the box to agree to Atlassian's developer terms
3. Click "Create"

Step 4: Configuring Callback URL

1. In the left sidebar, click "Authorization"
2. Under Callback URLs, enter the redirect URI:

   http://localhost:8000/api/v1/auth/jira/connector/callback

3. Click "Save changes"

Step 5: Configuring API Permissions

1. In the left sidebar, click "Permissions"
2. You'll see a list of available APIs including Jira API

Step 6: Configuring Jira API Scopes

1. Click "Configure" next to Jira API
2. Select the "Classic scopes" tab
3. Under Jira platform REST API, select the following scopes:

4. Click "Save"

Step 7: Obtaining OAuth Credentials

1. In the left sidebar, click "Settings"
2. Copy your Client ID and Client Secret

Deploying AINexLayer with Jira Connector

Add the Atlassian credentials to your .env file (created during Docker installation):

ATLASSIAN_CLIENT_ID=your_atlassian_client_id
ATLASSIAN_CLIENT_SECRET=your_atlassian_client_secret
JIRA_REDIRECT_URI=http://localhost:8000/api/v1/auth/jira/connector/callback

Then restart the services:

docker compose up -d