# Integration with Jira

{% hint style="info" %}
This feature is part of the Enterprise plan. If it is not enabled for your organization, please contact StrongDM at the [StrongDM Help Center](https://help.strongdm.com/hc/en-us).
{% endhint %}

StrongDM's integration with Jira, when paired with the [Approval Workflows](https://docs.strongdm.com/admin/access/approval-workflows) feature, allows you to browse the StrongDM resource catalog and request access to resources within Jira. It also provides a way for approvers to initiate StrongDM workflows to approve access requests. This integration gives you the ability to easily request access to the resources you need without opening another application.

This guide describes configuration of the integration within your Jira instance. To learn about how to use the integration to request or approve access, see [Request Access with Jira](https://app.gitbook.com/s/HaY8OFbXUreWEF61MhKm/access-requests/jira-requests).

### Enable the Integration in StrongDM

Before the integration can be used, you need to connect StrongDM to your Jira instance. To configure the integration for your organization, in StrongDM's Admin UI go to **Integrations** and under Jira, click **Connect**. This brings you to the Jira Marketplace, where you can locate the integration by searching for "StrongDM" and install and set up the integration with your Jira instance.

Once the setup process is complete, the integration with Jira becomes available for use by administrators of your Jira instance.

From the **Integrations** page you can also disconnect an integration at any time. In the list of currently configured integrations, you can click the **Disconnect** button to remove that integration from your StrongDM organization.

### Set up an Access Workflow in StrongDM

In order to use the integration with Jira to make and approve access requests, you must have at least one Access Workflow (and at least one Approval Workflow) enabled in your StrongDM organization. In the Admin UI, under **Access**, you can create an Approval Workflow (with the **Approval Step** "Jira Approval). You can then create an Access Workflow, specify which roles you'd like to be able to make requests, which resources they can request, and which Approval Workflow you'd like these requests to use, by selecting the Jira Approval Workflow you just created.

For more detail on Access Workflow setup, see our [Access Workflows](https://docs.strongdm.com/admin/access/access-workflows) section.

### Jira Configuration

1. Go to the [Atlassian Marketplace](https://marketplace.atlassian.com) and search in the top bar for "StrongDM". Locate the integration and follow the prompts to install it for the site that you wish it to be available on.<br>

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Note that there are separate apps for the US, EU, and UK StrongDM control planes. This refers to the control plane the StrongDM organization was set up on, not the individual location of users.</p></div>
2. After installing the plugin, select the configuration option to link your StrongDM user to Jira. This redirects you to the Admin UI, where you will connect your currently logged-in user to the Jira user. Once this is successfully completed, you will be returned to the Jira instance configuration.
3. Back in Jira, you will see a list of up to ten of your projects that you could enable the integration on. This limited set is only a subset that is listed here to be helpful for quick setup in some circumstances, but it doesn't represent a full list of your projects. You can get to the configuration for StrongDM for one of those projects by clicking the **Enable** button, or you can open any Jira project in your instance, go to **Project Settings** in the left sidebar, and click on **StrongDM** in the left sidebar.
4. Once in the StrongDM configuration screen, check the **Enable StrongDM** box.
5. In the **Project status to trigger an access grant in StrongDM** field, choose an issue status which, when it is selected on any given issue, triggers the access workflow.

{% hint style="info" %}
When selecting a triggering status, it is often best to choose one that is the end of that issue's flow through your system, such as "Resolved" or "Completed". If the ticket is later moved to another status, this does not undo StrongDM's access grant. Likewise, if this status is then added to this issue again, the grant is not re-issued. This is a one-time trigger of an approval for a single issue.
{% endhint %}

6. Finally (if using Jira Service Management), choose the Jira request types that you would like StrongDM options to be displayed on and workflows to be run for. Note that any new request form of the selected type will present StrongDM options to the user, so it is ideal to have specific request types that are only for requesting access to resources through StrongDM.

***

Please view the [StrongDM Privacy Policy](https://www.strongdm.com/privacy) for information about how StrongDM collects, manages, and stores third-party data.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.strongdm.com/admin/access/approval-workflows/jira-workflows.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.