> For the complete documentation index, see [llms.txt](https://docs.teleskope.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.teleskope.ai/connectors/saas/jira.md).

# 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](https://developer.atlassian.com/console/myapps/) 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.

{% hint style="info" %}
The client secret is displayed only once after creation. Save it securely before closing the dialog.
{% endhint %}

## Enroll the Jira Connector

{% stepper %}
{% step %}

### Open Jira settings

1. In Teleskope, go to **Settings → Connectors**.
2. Select **Jira** from the connectors list.
3. Click **Enroll**.
   {% endstep %}

{% step %}

### 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.
{% endstep %}
{% endstepper %}