Connect to Jira Server

Connecting qTest Manager and Jira Server gives testers access to Jira information in real-time for requirements and defects and provides developers access to information about Defects, including the steps leading to the error so that developers can reproduce the Defect.

To use the integration, connect qTest Manager and Jira Server at the project level. For information about the permissions needed to set up and configure a Server connection, refer to Which Jira Permissions Are Required to Set Up a Connection?

Rate-limiting was introduced by Atlassian with Jira 8.6. If you are using Jira Server/Data Center 8.6 or above, refer to Jira Rate Limiting for information on how rate-limiting may affect your qTest environment.

Prerequisites for qTest SaaS + Jira Server

The following is required to establish a connection between qTest SaaS and Jira Server. If you are using qTest OnPremises and Jira Server, you will skip this section. You may need to incorporate your IT infrastructure team to help with the connection.

qTest does not support SSO authentication when integrating to Jira.

IP Address and Firewall Configuration

  1. Verify your Jira Server's IP address is configured to be a public IP address, so your Jira instance is accessible publicly.

    If your company wants to have 1 Jira URL for public communication with qTest and another URL for local access only you will need to set up a reverse proxy.
  2. Ask your IT department to configure your Jira Server and firewall's settings to accept accesses/requests to/from the following specific Amazon servers elastic IPs. This must be a bi-directional set up accepting inbound and outbound requests between the qTest Amazon Elastic IPs and your Jira Server.

    The reason for doing this is that we have APIs to send to Jira to receive information and use other Jira APIs to be notified of changes in Jira for auto-sync of objects to qTest. Only when you allow the communication between two servers, the integration between qTest and Jira is successful.

Refer to Amazon Server Elastic IP Addresses Master List.

To establish the connection between Jira Server and qTest Manager SaaS, do the following:

  1. If your Jira Server protocol is HTTP (80. 8080) or https (443), make sure you open the correct ports.

  2. If you encounter an issue, refer to How do I troubleshoot my Jira connection?

  3. Install the free Jira Integration: qTest Enterprise add-on from the Atlassian Marketplace.

Configure Jira Server Integration Without Using OAuth Token

  1. From the qTest project, position the arrow cursor over the gear icon located in the top right area of the screen and select the Integration Settings option.

  2. The Integration Settings page loads. In the External Systems section, select Jira.

  3. The Configure Integration information for Jira page displays.

  4. Select the Add Jira Connection icon. The Add Jira Connection dialog opens.

    • Connection Name: Enter a name that represents your Jira instance.

    • Server URL: Enter the URL of your Jira server, which will likely contain the IP address and port information.

      The Server URL must match your Jira Base URL. This is the official address for traffic and APIs communication between qTest and Jira. Go to Jira > Administration > System to verify your Jira Base URL. You must whitelist your Jira Base URL.
    • Web URL: Enter the Jira URL your company uses. For a reverse proxy, enter the Jira URL for local access here.

    • Username: Must input a Jira username in this dialog.

    • Password: Password for the Jira Username entered above.

  5. After entering the Jira connection details, select the Test Jira Connection button. If the connection between qTest Manager and Jira is successful, the following message is displayed:

    'Connected to server successfully.'

    If the connection is not

    • When you select the Test Jira Connection button, qTest backend services running on the provided IPs will try to send a REST API call to your Jira instance at the provided endpoint. Therefore, make sure that you have changed your system and network firewall to accept inbound connections coming from those IPs, which is entirely different from allowing traffic to flow to these IPs from your Jira server (outbound).

    • When it comes to outbound traffic from your Jira server, our webhook services do not have a static public IP address and it's strongly advisable for you to allow outbound traffic to your qTest domain instead, which should be https://<domain>

  6. Select the Save and Configure icon.

  7. The Configure Connection information page displays. From this screen, you will configure the Defect integration with Jira and then import Requirements from Jira.

Configure Jira Server using OAuth Token

The following procedure is an alternative way to allow qTest Manager and Jira Server applications to connect.

qTest provides a default private key, but you also have the option to upload your own private key. You will upload your private key in the Security tab of Site Administration before connecting with Jira OAuth.

Configure Your Connection

  1. From your Jira instance, navigate to the Jira Administrator drop down.

  2. Select Applications and the Jira Administration page loads.

  3. Select Application links in the Integrations section of the left panel.

  4. Enter the URL of the application you want to link with. In this case, input your qTest instance URL, and select Create New Link.

  5. In the next dialog, select Continue.

  6. The Link Applications dialog displays. Enter information for only the Application Name.

  7. The Application Type should automatically be set to Generic Application. Keep this, and select Continue.

  8. You will be sent back to the Configure Application Links dialog with a list of items. Select Edit to configure.

  9. The Configure Application Links page loads.

  10. To create a new application link, enter your qTest Manager instance’s URL in the text field and select the Create new link button.

  11. After the link is created, configure the connection as follows. Select the Incoming Authentication tab from the Configure dialog and enter the following:

    • Consumer Key: qTest

    • Consumer Name: hardcoded-consumer

    • Public Key:

      If you are an existing customer and want to use your own private key, you will need to update your Jira configuration to account for the new Private Key you uploaded in the Security tab of Site Administration in qTest.
  12. Delete the current Incoming Authentication configuration in Jira.

  13. Re-enter the Consumer Key, Consumer Name, and Public Key referenced above.

  14. Save.

  15. Navigate toqTest Manager, and select Add Connection. The Add Jira Connection page is displayed.

    If you are using the private key option, you will need to reconfigure your Manager application and authorize the URL again with a new verification code.
  16. Enter the Connection Name and Server URL of your Jira instance. (Server URL is the Base URL of your Jira instance and is found in your Jira System Settings.)

  17. Select the Use Jira OAuth hyperlink and qTest will create an authorization URL.

  18. Select the Authorize URL hyperlink and select Allow in the Welcome to Jira pop-up.

  19. An 'Access Approved' message will display and you will need to obtain the verification code from the text on the webpage.

  20. Enter the Verification Code and select Submit.

  21. Submit the connection Information, and select the Test Jira Connection icon.

  22. Once the connection is tested successfully, select Save and Configure.

    The Configure Connection page displays. From this screen, you can both configure Defect integration with Jira and import Requirements from Jira.