Note: This support document is related to integrating with on-premise Jira Server, not Jira Cloud.
Aha! supports an integration with Jira so that releases, features, and requirements created in Aha! can be sent to Jira for an engineering team to work on. The integration uses the Jira REST API to create and update records in Jira while Jira webhooks are used to notify Aha! of changes in Jira. This allows Aha! to keep the feature status and other fields in sync with Jira as defined in your integration configuration. Communication between Aha! and Jira occurs over HTTPS in both directions.
Recommendations for network configuration
Following these recommendations is not essential, but doing so improves the usability and security of the integration.
- Aha! makes asynchronous inbound calls to Jira, so the Aha! data center IP addresses must be whitelisted in any firewall configuration. See "Whitelist IP addresses for on-premise versions of Jira" for current IP addresses.
- Use split DNS for the Jira server — so the same DNS name can be used for access to Jira both inside and outside the firewall. In API responses that Jira sends, it includes the URL for attachments. If the URL provided by the server is only resolvable from the LAN, then Aha! will not be able to synchronize attachments that were added in Jira to Aha!
- Use a web proxy for incoming requests to Jira so that the connection from Aha! can be terminated in the DMZ.
Recommendations for secure configuration in Jira
- Create a new Jira user specifically for the integration with Aha! The credentials for this user will be entered into Aha! Doing so allows permissions to be customized and allows traceability of changes made by integration. All changes made in Jira by Aha! will be attributed to this user.
- Limit permissions of the integration user to only the projects in Jira that will be integrated with Aha!
- Use a JQL filter in the webhook configuration to limit the webhook to only send information for projects that are integrated with Aha!
- Aha! can recommend a JQL query for you in the Enable step of Jira integrations 2.0. Once you have set up a Jira integration for each of your desired products, click the Generate recommended JQL query link to generate a JQL query based on your enabled Jira integrations. This recommended query ensures that only activities related to integrated projects are sent to Aha! from Jira. If you have projects that you do not wish to be shared with Aha!, then this filter will ensure that data never flows through the webhook.