Set up and Configure the Integration With Jira
Last modified on November 15, 2024
This feature is part of the Enterprise plan. If it is not enabled for your organization, please contact StrongDM at the StrongDM Help Center.
StrongDM’s integration with Jira, when paired with the Access 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 Use the Integration With Jira.
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 section.
Jira Configuration
- Go to the Atlassian Marketplace 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.
- 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.
- 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.
- Once in the StrongDM configuration screen, check the Enable StrongDM box.
- 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.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.
- 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 for information about how StrongDM collects, manages, and stores third-party data.