Connect to Jira Cloud

qTest offers a seamless connection between qTest SaaS and your Jira Cloud instance. There are two ways to establish this connection: using an API token and using an OAuth token.

For information about the permissions needed to set up and configure a Cloud connection, refer to Which Jira Permissions Are Required to Set Up a Connection?

Prerequisite Information

Before configuring your connection, you must first install the free Jira Integration: qTest Enterprise add-on from the Atlassian Marketplace.

Configure Jira Cloud with the API Token

Create a New Jira Cloud Connection with the API Token Video

Watch in full screen for best picture quality.

Create a New Jira Cloud Connection with the API Token

Follow these steps to configure a connection between Jira Cloud and qTest using the API token.

  1. Navigate to the qTest project, and select the gear icon in the toolbar.

  2. Select Integration Settings. The Configure Integrations page displays.

  3. Select Jira in the External Systems panel. The Configure Integration: Jira page displays

  4. Select Add Jira Connection. The Add Jira Connection page is displayed.

  5. Enter information in the fields as described below:

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

    • Server URL: Enter the URL of your Jira instance.

    • Web URL: This field is only needed when setting up the connection between qTest Manager and Jira Server.

    • One-time Password: If this is the first time you're adding a Jira connection, enter the one-time password from your Jira instance. To find the one-time password after you install the integration, in Jira, go to Apps > Manage App and select Get started under Tricentis qTest Integration for Jira. This isn't required if you're adding a new Jira connection and you've previously added a Jira connection to a different project.

      Please note that you must also enter this one-time password again if you are editing an existing connection.

    • Username: Enter a Jira Global Admin username in this field. A global administrator in Jira is the same as a site administrator. For information on setting up Jira administrator permissions, refer to Manage Jira Global Permissions.

    • Password or Token: Enter the Jira Token to establish a connection. On December 1, 2018, Atlassian deprecated the ability to authenticate with the username and password of a Jira Global Admin. For more information, refer to the following Atlassian Announcement: Deprecation Notice.

  6. After entering the Jira connection details, select Test Jira Connection.

    If the connection between qTest Manager and Jira is successful, the following message is displayed: "Connected to the server successfully."
  7. 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.

Edit an Existing Jira Cloud Connection to use the API Token

If you are editing an existing integration, connection follow these instructions:

  1. Navigate to the qTest project, and select the gear icon in the toolbar.

  2. Select Integration Settings. The Configure Integrations page displays.

  3. Select Jira in the External Systems panel. The Configure Integration: Jira page displays

  4. In the Connection Name column, select the blue hyperlink of your Jira Integration name.

  5. When the Add Jira Connection dialog opens, and select the blue hyperlink for 'Instructions to create an API token' which redirects you to the Atlassian instructions.

  6. Once you retrieve the API Token, enter it in the Password or Token field. Learn how to create an API token with the Atlassian documentation (opens in a new window).

  7. Enter the One-time Password from your Jira instance to re-verify the connection. To find the one-time password after you install the integration, in Jira, go to Apps > Manage App and select Get started under Tricentis qTest Integration for Jira.

  8. Select the Test Jira Connection icon.

  9. When the connection is tested, you can 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.