Aha! Roadmaps | Integrate with Jira Server (integrations 2.0)

Successful products do not happen by accident. They are often the result of seamless collaboration between product and development teams. Developers need strategic context for their work. Product managers need progress updates to inform their roadmap.

But all too often, product managers have to use developer tools just to provide context and track updates — then manually update their own product plans elsewhere. They spend their days in multiple tools, trying to be the glue that brings strategic vision and successful go-to-markets together.

The integration between Aha! Roadmaps and Jira Server, Atlassian's on-premises product, keeps product and development teams in their tools of choice — without sacrificing context or collaboration. Real-time, two-way updates mean that strategic and progress updates flow back and forth immediately. And you can customize the integration to match your team's workflow and terminology.

Note: Atlassian plans to end support for Jira Server in early 2024. If you are a current Jira Server customer, it is time to start thinking about migrating your account to Jira Cloud.

Click any of the following links to skip ahead:

Prerequisites

Integration type

  • Two-way

Supported versions

  • Jira Cloud

  • Jira Server (6.0 and higher)

  • Jira Data Center

Aha! Roadmaps level

  • Workspace level

Required user permissions:
Configuration

Required user permissions:
Use integration

Associated record types

  • Initiatives

  • Releases / Schedules

  • Epics

  • Features / Activities

  • Requirements

Top

How to think about the integration

The Aha! Roadmaps Jira integration is two-way, which means information can be updated in either tool. Send your planned work to Jira, get notified when the Jira issue's status updates, and use comments to keep each team up to date.

Before configuring any integration for the first time, it is important to fully understand how to think about integrating Aha! Roadmaps with your development tool. Aha! Roadmaps should come first in the process —build out or import your records in Aha! Roadmaps, then send them to Jira. You can customize the ways that fields map to each other between the two tools, and even customize whether you want integrated records to update automatically, or only after your review.

This integration supports sending the following Aha! Roadmaps records to Jira:

  • Initiatives

  • Releases / Schedules

  • Epics

  • Features / Activities

  • Requirements

Top

Integration structure

The integration uses the Jira REST API to create and update records in Jira while Jira webhooks are used to notify Aha! Roadmaps of changes in Jira. This allows Aha! Roadmaps to keep the record status and other fields in sync with Jira as defined in your integration configuration — and to provide links to access Jira Server issues directly. Communication between Aha! Roadmaps and Jira occurs over HTTPS in both directions.

Top

Recommendations for network configuration

Following these recommendations is not essential, but doing so improves the usability and security of the integration.

  • Aha! Roadmaps makes asynchronous inbound calls to Jira, so the Aha! Roadmaps data center IP addresses must be allow listed in any firewall configuration using current IP addresses.

  • Aha! Roadmaps requires a publicly resolvable, valid JIRA Server URL to link to in the integration.

  • 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! Roadmaps will request attachments from the Jira server domain defined in the integration settings instead of the location of the attachment.

  • Use a web proxy for incoming requests to Jira so that the connection from Aha! Roadmaps can be terminated in the DMZ.

Top

Recommendations for secure configuration in Jira

  • Create a new Jira user specifically for the integration. The credentials for this user will be entered into Aha! Roadmaps during the configuration setup. Doing so allows you to customize permissions, and allows you to trace any changes made by the integrations. All changes made in Jira by Aha! Roadmaps will be attributed to this user.

  • Limit the integration user's permissions to the Jira projects that will be used in the integration.

  • Use a JQL filter in the webhook configuration to limit the webhook to only send information for projects used in the integration.

  • Aha! Roadmaps 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! Roadmaps from Jira. If you have projects that you do not wish to be shared with Aha! Roadmaps, then this filter will ensure that data never flows through the webhook.

Top

Add additional security

2.0 integrations with on-premises tools have the option to include a client certificate for added integration security.

To set a client certificate, open your integration settings and click the More options icon in the upper right, then click Set client certificate. From here, enter the private key and certificate — we recommend creating a private key and client certificate specifically for this purpose — and click Save to save your changes.

Note: This feature will only provide additional security when the server that Aha! Roadmaps is communicating with validates the certificate. This is usually only possible with customer-configured on-premises integrations. Client certificate authentication is in addition to the standard username and password/token authentication and is not a replacement.

Top

Aha! Roadmaps
    Strategic roadmaps
    Account management
    Integrations
      Aha! Roadmaps | Integrate with Dropbox
      Aha! Roadmaps | Integrate with Google Calendar
      Aha! Ideas
      Videos
      Announcements
      © 2021 Aha! Labs Inc.All rights reserved