Jira

Connect your Jira Cloud instance to Teleskope to catalog, classify, and remediate sensitive data across issues, comments, attachments, and custom fields.

Prerequisites

• A Jira Cloud instance (Jira Software, Jira Service Management, or Jira Work Management)

• Jira site administrator access

• An Atlassian account with permission to create OAuth 2.0 apps in the Atlassian developer console

Create an OAuth 2.0 App in Atlassian

Teleskope connects to Jira via OAuth 2.0. Before enrolling, you need to create an OAuth app in the Atlassian developer console and note your credentials.

Create the app

1. Go to the Atlassian developer console and sign in with your Atlassian account.

2. Click Create and select OAuth 2.0 integration.

3. Give the app a name (e.g., Teleskope) and accept the terms. Click Create.

Configure permissions

1. In your new app, go to Permissions in the left sidebar.

2. Find Jira API and click Add then Configure.

3. Under Classic scopes, add the following scopes:

   • read:jira-work — read access to issues, comments, and attachments

   • read:jira-user — read access to user and project data

   • write:jira-work — required for remediation actions (overwriting comments, deleting attachments)

4. Under Granular scopes, also add:

   • read:issue:jira

   • read:comment:jira

   • read:attachment:jira

   • write:comment:jira

   • delete:comment:jira

   • delete:attachment:jira

Set the callback URL

1. Go to Authorization in the left sidebar.

2. Next to OAuth 2.0 (3LO), click Add and enter your Teleskope callback URL.

3. Your callback URL is unique to your Teleskope instance. You can find it on the Jira connector enrollment page in Teleskope under Settings → Connectors → Jira.

Retrieve your credentials

1. Go to Settings in the left sidebar of your app.

2. Note the Client ID and Secret. You will enter these in Teleskope during enrollment.

The client secret is displayed only once after creation. Save it securely before closing the dialog.

Enroll the Jira Connector

1

Open Jira settings

1. In Teleskope, go to Settings → Connectors.

2. Select Jira from the connectors list.

3. Click Enroll.

2

Enter your credentials

On the enrollment page, fill in:

1. Site URL — Your Jira Cloud site URL (e.g., https://yourcompany.atlassian.net)

2. Client ID — The client ID from your Atlassian OAuth app

3. Client Secret — The client secret from your Atlassian OAuth app

Click Enroll to initiate the OAuth authorization flow. You will be redirected to Atlassian to grant access. After approving, you are returned to Teleskope and the Jira instance appears in the enrolled list.