Gearset's Jira integration will automatically post updates to Jira tickets when you run validations and deployments. These updates will contain a link back to the Gearset deployment report. This feature makes tracking the status of your user stories and support tickets faster and easier. We support both Jira Self-hosted (a.k.a. on prem) and the default Jira Cloud instance.
Connecting to the on-premise Jira server (administrator)
So Gearset can talk to your on-premise Jira server, your Jira administrator / networking team should ensure:
If you are using proxy authentication, note that Gearset needs to be able to speak to the Jira server directly, which will then kick off the OAuth flow without an additional authentication wall in front of it.
If your account uses 2FA, you may need to create a custom application password for Gearset to connect to your system.
To ensure a secure connection, Gearset will only connect using
https and your server needs to be set up with a valid certificate from a CA. Self-signed certificates are not supported as they can't guarantee a secure connection.
Initial Jira setup (team owner)
First, you need your Jira administrator to create an application link in Jira itself, and authorize Gearset. Doing this provides a mechanism for Gearset to authenticate against Jira and post updates to tickets. This only has to be completed once, and afterward users can set up connections to Jira with a few clicks.
Connecting to your Jira instance
Under Source control and services you have the option to connect to various source control repositories and issue tracking services, including Jira.
If you click on the
+ Connect to Jira option on the right-hand side of the screen, you will be given the option to connect with either Jira Cloud or Jira Self-hosted.
You should take note of the
Consumer key and
Public key that are generated.
You can now follow the normal flow of setting up a Jira connection as detailed in our integrating with Jira document here. Select "Atlassian product" if prompted for the type of application you want to connect to.
Considerations when using a reverse proxy
Are using a reverse proxy to provide Gearset access to your Jira instance,
The URL provided to Gearset (i.e. your reverse proxy URL) is not the same as Jira's base URL
Then the connection setup may fail when connecting Gearset to Jira due to the mismatch between the reverse proxy URL and Jira's base URL.
If this occurs you can set the
Internal URL option to the same as the
Base URL as defined with Jira's
General Configuration page:
Jira Base URL configuration
Gearset Jira Self-hosted configuration with Internal URL matching Jira Base URL