Integrating with Jira Server (On-Premise)
Note: FireHydrant supports Jira 8.x versions out of box. If you are using Jira 9.x, please reach out to support and ask to have it enabled for your organization.
FireHydrant can create tickets in Jira for each of your incidents, with linked tickets for follow-ups to prioritize after the incident. This way all of the actions proposed during an incident are tracked in your existing project management workflows for estimation and scheduling.
A user who is both a Jira Server administrator and an Owner in FireHydrant must configure this integration.
Note: FireHydrant recommends using a generic Jira Server service account rather than an individual named user to avoid problems if the named employee were to depart the organization.
The Jira Server service account used to authorize the integration must have these minimum functional permissions:
- Project Permissions
- Browse Projects
- Issue Permissions
- Assign Issues
- Close Issues
- Create Issues
- Edit Issues
- Link Issues
- Move Issues
- Schedule Issues
Some of the other things the Service Account should have access to include:
- Read all Jira ticket types to be used with FireHydrant.
- Read all Jira fields and custom fields to be mapped in FireHydrant.
We have static IP addresses we make all requests from. If your Jira Server instance is behind a network perimeter or firewall, you can add the following two IPs to the allowed list so FireHydrant can access your Jira:
Note: If you are using SSO with Jira Server, make sure that the Jira service account you use to authorize the integration is exempted from SSO (i.e. configured to authenticate with username and password instead).
Go to Integrations > Jira Server (on premise) and click the '+'.
On the setup page, fill in the information for the integration:
- API Base URL: The URL + port (if applicable) to your Jira server instance.
- Username: The username of the Jira service account you are using for this integration
- Password: The password of the Jira service account you are using for this integration
Click Authorize Application.
To see updates to your tickets reflected in FireHydrant, add a Webhook to Jira. In FireHydrant access the Jira Cloud integration settings, and copy the Webhook URL.
In Jira, have your Jira administrator configure a Webhook listener for FireHydrant using the copied URL. Set this webhook for the projects you plan to use with FireHydrant (or all issues), and then check the Issue created and Issue updated boxes.
Now that you've got the Jira integration installed, you can proceed to set up Project Configurations. This will be required before you can make use of other FireHydrant <> Jira capabilities.
For troubleshooting, visit our Troubleshooting Jira Issues article.