## Integrate Jira Data Center URL: https://docs.atlan.com/product/integrations/project-management/jira/how-tos/integrate-jira-data-center > You will need to [configure an incoming link](https://confluence.atlassian.com/adminjiraserver/configure-an-incoming-link-1115659067.html) with an external application - in this case, Atlan. This will allow Atlan to access Jira data, which means that Jira will act as the OAuth provider. :::warning Who can do this? You will need to be an [admin](https://docs.atlan.com/llms/governance/access-control/delegate-administration/llms.txt) in Atlan to configure the Jira Data Center integration. You will also need inputs and approval from an administrator of your Jira workspace. ::: :::warning If your Jira Data Center instance is behind a VPN or firewall, you must add the Atlan IP to your allowlist. Please raise a support ticket from within Atlan, or [submit a request](https://docs.atlan.com/support/submit-request). (If you are not using the IP allowlist, you can skip this step.) ::: To integrate Jira Data Center and Atlan, follow th ese steps. ## Configure an incoming app link in Jira Data Center You will need to [configure an incoming link](https://confluence.atlassian.com/adminjiraserver/configure-an-incoming-link-1115659067.html) with an external application - in this case, Atlan. This will allow Atlan to access Jira data, which means that Jira will act as the OAuth provider. Atlan requires the [minimum scope](https://confluence.atlassian.com/adminjiraserver/oauth-2-0-scopes-for-incoming-links-1115659069.html) of `WRITE` to create issues in Jira Data Center. However, actual permissions are capped at what the authorizing user can do. For example, if the authorizing user lacks the permission to delete issues or projects, then Atlan will not have the permission to do so even with the `WRITE` scope. To configure an incoming link for Atlan, from within Jira Data Center: 1. Log in to your Jira instance. 2. [Copy the Jira site URL](https://confluence.atlassian.com/jirakb/how-to-find-your-site-url-to-set-up-the-jira-data-center-and-server-mobile-app-954244798.html) from your browser's address bar and store it in a secure location. If you're viewing the dashboard, the site URL is everything that comes before `/secure/Dashboard.jspa`. 3. From the top right of your Jira instance, click the settings icon, and from the dropdown, click **Applications**. 4. In the left menu of the _Applications_ page, under _Integrations_, click **Application links**. 5. From the top right of the _Application links_ page, click **Create link** to create a new application link for Atlan. 6. In the _Create link_ dialog, enter the following details: 1. For _Application type_, click **External application** to link to an external application using OAuth 2.0. 2. For _Direction_, click **Incoming** to allow Atlan to access data from Jira. 7. In the corresponding _Configure an incoming link_ page, enter the following details: 1. For _Name_, enter a meaningful name for your application - for example, `Atlan_integration`. 2. Under _Application details_, for _Redirect URL_, enter the redirect URL in the following format - `https://${client-domain}.atlan.com/oauth-callback`. 3. Under _Application permissions_, for _Permissions_, click the dropdown and then click **Write**. The [_WRITE_ scope](https://confluence.atlassian.com/adminjiraserver/oauth-2-0-scopes-for-incoming-links-1115659069.html) will allow Atlan to: - View projects and issues - Create, update, and delete projects and issues 4. Click **Save** to save your selections. 8. From the corresponding _Credentials_ page, click **Copy** to copy the _Client ID_ and _Client secret_ and store them in a secure location. ## Connect Atlan to Jira Data Center Once you have retrieved the [Jira instance URL and client ID and client secret](https://docs.atlan.com/llms/governance/integrations/integrate-jira-data-center/llms.txt) from Jira, you can proceed to connecting Atlan to Jira Data Center. :::warning You must have at least one issue already created in Jira before integrating it with Atlan. ::: To connect Atlan to Jira Data Center, 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, to the right of the **Connect** button, click the downward arrow and then click **Connect with Jira Data Center**. 4. A new _Jira Data Center_ window will open and you'll be asked to install the Atlan app and create an application link in Jira. Click **Next** to proceed. 5. In the corresponding _Jira Data Center_ dialog, for _Add credentials_, enter the following details: 1. For _Instance URL_, enter the [URL of your Jira instance](https://docs.atlan.com/llms/governance/integrations/integrate-jira-data-center/llms.txt). 2. For _Client ID_, enter the [client ID you copied](https://docs.atlan.com/llms/governance/integrations/integrate-jira-data-center/llms.txt) in Jira. 3. For _Client secret_, enter the [client secret you copied](https://docs.atlan.com/llms/governance/integrations/integrate-jira-data-center/llms.txt) in Jira. 6. In the _OAuth 2.0 Authorization Consent_ popup, click **Allow** to complete the connection. 7. Click the **Add to Jira** button to install the Atlan app in Jira Data Center. ## Install Atlan app in Jira Data Center Before you can install the Atlan app in Jira Data Center, navigate to the [Atlan for Jira Data Center app](https://marketplace.atlassian.com/apps/1232314/atlan-for-jira-data-center?tab=overview&hosting=datacenter) URL and click **Get it now** to download the app. To install the Atlan app, from within Jira Data Center: 1. Log in to your Jira instance. 2. Under _Administration_, from the tabs along the top, click **Manage apps**. 3. From the left menu under _Atlassian Marketplace_, click **Manage apps**. 4. From the upper right of the _Manage apps_ page, click **Upload app**. 5. In the _Upload app_ dialog, for _Upload the .jar or .obr file for a custom or third-party app here._, select the [app file you downloaded](https://marketplace.atlassian.com/apps/1232314/atlan-for-jira-data-center?tab=overview&hosting=datacenter). 6. Click **Upload** to complete the installation. 7. Changes to the apps in your instance will affect Jira search index. After you make changes to the app, you'll get the following message in the _Administration_ view: _We recommend that you perform a re-index, as configuration changes were made to `SECTION` by `USER` at `TIME`. If you have other changes to make, complete them first so that you don't perform multiple re-indexes_. You will need to perform a full re-index for the integration to succeed, follow the steps in the [official Jira documentation](https://confluence.atlassian.com/adminjiraserver/search-indexing-938847710.html) to do so. ## Configure integration from Atlan to Jira Data Center To configure the Jira Data Center 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, for _Projects_, select the Jira project to use as your default project from the dropdown and click **Update**. 3. (Optional) At any future time, you can review the **Overview** tab to see the number of linked issues between Jira Data Center and Atlan. Atlan is now connected to Jira Data Center! 🎉 :::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. ::: ---