Jira Software Datacenter is in Early Access. Please reach out to your CSM if you would like to participate in the early access program.
This document walks through the server configuration for Jira Software Datacenter required for integration with Thoropass. For more information about how to integrate and setup your Thoropass action item Jira Project and some automation best practices, see here: https://app.intercom.com/a/apps/iuhhzrn9/articles/articles/article-contents/8906442/edit.
If you are running into issues connecting to Jira Software Datacenter, ensure all of the following requirements are met.
Version Support
Thoropass supports the latest LTS version of Jira Sotware Datacenter. As of the time of writing the version is Version 6.12 LTS.
Most modern versions should work as API changes are typically minimal. It is recommened to upgrade to the latest LTS version of JIRA On-Prem datacenter.
More information about Jira version support:
https://www.atlassian.com/software/jira/update
Server Configuration
Your Server needs to run over HTTPS
See this guide from Atlassian. HTTPS is required for Thoropass.
Your Jira Software Datacenter base URL must be correctly configured
Jira automatically detects the base URL during setup. However, you may need to set it manually if your site's URL changes or if you set up Jira from a different URL to the one that will be used to publicly access the app.
To configure the base URL:
In the upper-right corner of the screen, select Administration > System.
In the sidebar, select General configuration.
Select Edit settings.
Enter the new URL in the Base URL text box.
Select Update to save your changes.
Network Configuration
Open JIRA Software Datacenter on your firewall
Open at least port 443 inbound and outbound to these Thoropass IP addresses.
Setting base URLs behind proxies
If you are running behind a proxy, ensure that the proxy name matches the base URL. For example: proxyName="foobar.com" proxyPort="443" scheme="https".
This will make sure we are passing the information correctly.
This information needs to be added in the Connector element at {Jira_INSTALLATION}\\conf\\server.xml.
Port 443 needs to be open for outgoing and incoming connections since the OAuth 2.0 authentication uses https connections.
More info here: https://confluence.atlassian.com/adminjiraserver0912/configuring-the-base-url-1346048133.html