Configuration
To set up the integration, you will need a ProductPlan account and Jira administrator access. To begin, go to your integrations page in ProductPlan, select the Jira Software card. On the next screen, click “Begin Jira Integration”, and enter your Jira base url:
Step 1: ProductPlan Configuration
If this is the first time someone from your team is configuring the integration, you will need to follow the Jira configuration from Step 2 below. If someone on your team has already done this, you will simply need to authenticate your Jira account. In this case, you will see the following screen. Just click “Allow” to authorize the integration:
Step 2: Jira Configuration
After entering your Jira base url on your integrations page in ProductPlan, you will be provided with the Consumer and Public Keys needed for completing the configuration. Go to your Jira account and follow the steps below to complete the integration:
From your Dashboards page, access “Jira Settings” from the menu on the left.
Under the Jira Settings menu select “Products” (Note: earlier Jira versions may say “Applications” or “Add-Ons”).
Select “Application Links” from under the Integrations section.
Enter this as the URL in the indicated field: https://app.productplan.com.
Click “Create new link”. If you get a warning saying “No response was received from the URL you entered”, click “Continue”.
Under Application Name, enter “ProductPlan”.
For Application Type, select “Generic Application”.
Do NOT fill out the remaining fields. Leave all remaining fields blank. Click “Continue”.
Click the “Edit” icon in the Actions column to the right of your newly created ProductPlan application.
Select “Incoming Authentication” (Note: you may need to scroll to the bottom of the modal in Jira to see all fields).
Enter the following values, provided from your integrations page in ProductPlan:
Consumer Key: (provided by ProductPlan)
Consumer Name: ProductPlan
Public Key: (provided by ProductPlan – copy everything, including the begin and end certificate lines)
Consumer Callback URL: https://app.productplan.com/auth/jira/callback
12. Click “Save”.
13. Return to ProductPlan and click “Next Step” at the bottom of the page. Click “Allow” to authenticate your account.
On-Premise Configuration
If your Jira server is on-premise (including Jira Server and Jira Data Center), you should still be able to integrate with ProductPlan. You will need to allowlist the ProductPlan IP Addresses in your firewall so that we can make connections to your Jira server. You can make the connection through port 443.
Use these IP addresses for the connections:
[52.5.38.201] and [52.7.247.138]
Or, if you want more restrictions you can also open the following URI’s:
[/plugins/servlet/oauth/*] and [/rest/api/*] and [/auth/jira/new]
For further assistance, please contact support@productplan.com.
Notes
If you use or plan to use Data Center v9, please contact your CSM or support@productplan.com for assistance.
If you see this error message while creating your connection, please check for common issues:
Jira Cloud
The Jira URL you entered may be incorrect.
Your organization may have IP Allowlisting security in place. Please work with your Jira administrator to enable the proxy and allow our IP addresses (noted above). Please also see this Jira article for more information.
A server may be down and you need to try again later.
A request times out. Please wait a few minutes and try again.
Jira Server or Data Center
The Jira URL you entered may be incorrect.
Our IP Addresses (noted above) must be allowlisted on your organization's firewalls. Please connect with your Jira administrator and IT team for assistance.
Your firewall needs to be configured to correctly route traffic to your Jira server.
A request times out. Please wait a few minutes and try again. If the problem persists, please contact your IT team for assistance.
Your server may be down or was made inaccessible over the internet