## Integrate Jira Cloud

URL: https://docs.atlan.com/product/integrations/project-management/jira/how-tos/integrate-jira-cloud

> You must have at least one issue already created in Jira before integrating it with Atlan. This will enable Atlan to detect whether the Atlan app is installed in your Jira workspace for the integration to work.

:::warning Who can do this?
 You will need to be an admin in Atlan to configure the Jira Cloud integration. You will also need inputs and approval from an administrator of your Jira Cloud workspace.

:::

To integrate Jira Cloud and Atlan, follow these st

eps.

## Connect Atlan to Jira Cloud

:::warning

You must have at least one issue already created in Jira before integrating it with Atlan. This will enable Atlan to detect whether the Atlan app is installed in your Jira workspace for the integration to work.

:::

Atlan uses the following [scopes](https://developer.atlassian.com/cloud/jira/platform/scopes-for-oauth-2-3LO-and-forge-apps/#scopes) for the Jira Cloud integration:

- `read:jira-user` - view user profiles
- `read:jira-work` - view Jira issue data
- `write:jira-work` - create and manage Jira issues
- `manage:jira-configuration` - manage Jira global settings
- `offline_access` - allows the Atlan app to refresh the access token

To connect Atlan to Jira Cloud from within Atlan:

1. In your Atlan workspace, click **Settings** from the left menu.

 If you are using the **Old UI (Classic)**, from the left menu, click **Admin**.
2. Under _Workspace_, click **Integrations**.
3. In the _Jira_ tile, click the **Connect** button.
4. A new window will open, where you'll be asked to log into your Atlassian account:
 1. To login with an email address, enter your email address, click **Continue**, and then enter your password and click **Log in**.
 2. To login with Google, Microsoft, or Apple, click the appropriate button and follow the instructions.
5. Once you're logged in, you will be asked to allow Atlan to access your Atlassian account. Scroll to the bottom of the window and click the **Accept** button.
6. If you have access to multiple Jira Cloud sites, for the _Connecting to Jira_ dialog, click the **Select environment** dropdown to select the Jira environment you want to connect to Atlan and then click **Connect**.

### Install Atlan Jira app

To install the Atlan Jira app:

1. Open the Atlan Jira app's page in the Atlassian marketplace, through either of these ways:
 - From the _Integrations_ page of Atlan, in the _Jira_ tile, click the **Add to Jira** button.
 - Directly navigate to the URL: [https://marketplace.atlassian.com/apps/1225577/atlan](https://marketplace.atlassian.com/apps/1225577/atlan)
2. In the upper right of the page, click the **Get it now** button.
3. At the bottom of the _Add to Jira_ dialog, click the **Get it now** button.

### (Optional) Request permission from your Jira Cloud admin

If you are not a workspace administrator in Jira, you will be prompted to request permission to install. To request permission to install the integration:

1. Under _Want this app? Let your admin know why_ enter an explanation for installing the app.
2. At the bottom of the form, click the **Submit request** button.
3. Contact your Jira workspace administrator and ask them to approve the Atlan app.
4. Once approved, you'll get an email from Jira telling you that the Atlan app is installed.

## Configure integration from Atlan to Jira Cloud

To configure the Jira Cloud integration from Atlan, from the _Integrations_ sub-menu:

1. Expand the _Jira_ tile. (You may need to refresh the page before the following options appear.)
2. Under the _Configurations_ tab, you can configure the following:
 1. For _Projects and issue type_, select the Jira projects for which your users are allowed to create tickets in Atlan. For each selected project, next to _Issue types_, click **Edit** to select the allowed issue types. (This will default to all projects and issue types, if none are specified.)
 2. For _Default Project_, select the Jira project to use as your default project from the allowed list of projects.
 3. Click **Update** to save your configuration.
3. (Optional) At any future time, you can review the **Overview** tab to see the number of linked issues between Jira and Atlan.

Atlan is now connected to Jira Cloud! 🎉

:::info **Did you know?** 
 The default project is preselected when creating or linking issues to an asset in Atlan. You can change the project while creating or linking issues as needed.

:::

## (Optional) Create a webhook for access management workflows

If your Atlan admin has [enabled the governance workflows and inbox module](https://docs.atlan.com/llms/governance/stewardship/automate-data-governance/llms.txt) in your Atlan workspace, you can either register a webhook in the Jira administration console or install it directly in Atlan to allow your requesters to view the latest status of their data access approval or revocation requests for governed assets.

This is only required if you:

- [Enable governance workflows](https://docs.atlan.com/llms/governance/stewardship/automate-data-governance/llms.txt).
- [Want to use the access management workflow to grant or revoke data access in a source tool using Jira](https://docs.atlan.com/llms/governance/stewardship/automate-data-governance/llms.txt).

In addition to the scopes mentioned [here](https://docs.atlan.com/llms/governance/integrations/integrate-jira-cloud/llms.txt), Atlan uses the following scope to manage Jira webhooks - `manage:jira-webhook`.

### From Atlan

You can directly install the webhook in Atlan if you're an admin in both your Atlan and Jira Cloud workspaces.

To install a webhook:

1. In your Atlan workspace, click **Settings** from the left menu.

 If you are using the **Old UI (Classic)**, from the left menu, click **Admin**.
2. Under _Workspace_, click **Integrations**.
3. Expand the _Jira_ tile. For _Get updates on data access requests (optional)_, click **Install**. Atlan will automatically install the webhook.

### From Jira

Your Jira admin will need to [register the webhook](https://developer.atlassian.com/server/jira/platform/webhooks/#registering-a-webhook) in the Jira administration console if your Atlan admin is not a Jira admin.

To register a webhook:

1. [Contact Atlan support](https://docs.atlan.com/support/submit-request) to provide you with the webhook secret.
2. Log in to the Jira administration console with the [Administer Jira global permission](https://support.atlassian.com/jira-cloud-administration/docs/manage-global-permissions/).
3. From the top right of the Jira administration console, open the settings menu, and then under _Jira Setting_s, click **System**.
4. From the left menu, under _Advanced_, click **WebHooks**.
5. From the top right of your screen, click the **Create a WebHook** button.
6. In the webhook creation form, enter the following details:
 1. For _Name_, enter a meaningful name - for example, `Atlan_webhook`.
 2. For _Status_, click **Enabled**.
 3. For _URL_, copy and paste `https://{atlan-domain}.com/api/service/jira/events` - replace `atlan-domain` with the name of your Atlan tenant.
 4. For _Secret_, enter the webhook secret provided by Atlan support. Note that if an invalid secret is used or this field is kept blank, the webhook configuration will be automatically removed from Atlan once an event is received in Atlan.
 5. Under _Events_, in the text box for _Issue related events_, paste `issue.property[atlan].guid is NOT EMPTY`.
 6. For _Issue_, click the checkboxes for **updated (jira:issue\_updated)** and **deleted (jira:issue\_deleted)**.
 7. Skip the rest of the fields. Click **Create** to register your webhook.

---