Menu

Connect to JIRA Integration

Connecting qTest Manager and JIRA gives testers access to JIRA information in real-time for requirements and defects.  This provides developers access to information about defects, including the steps leading to the error, so developers can reproduce the defect.  

Connect to JIRA Cloud

You must be a Project Administrator to set up this integration. 

To set up the connection between JIRA Cloud and qTest Manager, do the following.

  1. Install the free qTest for JIRA Test Management add-on from the Atlassian Marketplace.                 
  2. 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.



  3. In the left panel, under the EXTERNAL SYSTEMS tab, click the JIRA 6.0+ option.  



    The Configure Integration page is displayed, as shown below.



  4. Click the Add JIRA 6.0+ Connection button.  The Add JIRA 6.0+ Connection page is displayed.  Enter information in the fields as described below:



    1. Connection Name:  Enter a name that represents your JIRA instance.
    2. Server URL: Enter the URL of your JIRA instance.
    3. Web URL: This field can be left blank.  It is only needed when setting up the connection between qTest Manager and JIRA Server.
    4. Username: Enter a JIRA Global Admin username in this field.  A global administrator in JIRA is regarded as a site administrator.  For information on setting up JIRA administrator permissions, please see the JIRA article Manage JIRA Global Permissions.
    5. Password: Enter the Password for the JIRA Global Admin Username entered above.

  5. After entering the JIRA connection details, click the Test JIRA 6.0+ Connection button.  If the connection between qTest Manager and JIRA is successful, the following message is displayed.

    Connected to the server successfully.

  6. Click the Save and Configure button.   

    The Configure Connection page is displayed.  From this screen, you will configure defect integration with JIRA and then import requirements from JIRA.



    NOTE:  If you receive an error message after clicking the Save and Configure button, see the Common Roadblocks section near the end of this article.

NEXT STEPS:

See the following articles:

Connect using JIRA OAuth Token

The following procedure is an alternative way to allow qTest Manager and the JIRA cloud or JIRA server application to connect.  Perform the following steps.

  1. Select the Application links option in the left panel of your JIRA instance.  From the Configure Application Links page, to create a new application link, enter your qTest Manager instance’s URL.  Then, click the Create new link button.   
     

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

    C
    onsumer Key: qTest
    Consumer Name: hardcoded-consumer
    P
    ublic Key: Obtain the JIRA public key from the following link.  See the section entitled ‘Before you begin’.  (See the screenshot below.)



    https://developer.atlassian.com/jiradev/jira-apis/jira-rest-apis/jira-rest-api-tutorials/jira-rest-api-example-oauth-authentication

  3. In qTest Manager, add a connection to your JIRA instance, as follows.
    1. Click the Add Connection button.  The Add JIRA 6.0+ Connection page is displayed.
    2. Enter the Connection Name and Server URL of your JIRA instance.
    3. Click the Use JIRA OAuth URL.
    4. Click the Authorize Url URL.  Obtain the verification code.
    5. Enter the Verification Code and click the Submit button.



NEXT STEPS:

See the following articles:

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 developers can reproduce the defect.  

To use the integration, connect qTest Manager and JIRA Server at the project level.  You must be a Project Administrator to use this functionality.  

Prerequisites for qTest Cloud + JIRA Server

If you are using JIRA Server and qTest On-Premise, you may skip this section.  The following is required to establish a connection between qTest Cloud and JIRA Server.  You may need to incorporate your IT infrastructure team to help with the connection.  

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 from the public.  

  2. Configure your firewall settings to accept accesses/requests from the following specific Amazon servers' elastic IP addresses.  This must be a bi-directional set up accepting inbound and outbound requests between the qTest Amazon Elastic IPs and your JIRA Server.
    • 54.83.56.253
    • 54.83.57.47
    • 54.83.57.78
    • 54.83.57.122
    • 54.83.57.143
    • 54.83.57.153

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

    If you encounter an issue, please see the articles FAQs for JIRA troubleshooting and Permissions Issues needed for JIRA troubleshooting 

Establish Connection to JIRA Server in qTest Manager

To establish the connection between JIRA Server and qTest Manager, do the following.

  1. Install the free qTest for JIRA Test Management add-on from the Atlassian Marketplace.                 
  2. 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.



  3. Select the Integration Settings option.

  4. in the left panel, under the EXTERNAL SYSTEMS tab, click the JIRA 6.0+ option.

     

    The Configure Integration page is displayed, as shown below.



  5. Click the Add JIRA 6.0+ Connection button.  The Add JIRA 6.0+ Connection page is displayed.

     
    • 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.
    • Web URL: Enter the JIRA URL your company uses.
    • Username: Must input a JIRA username in this dialog.
    • Password: Password for the JIRA Username entered above.

  6. After entering the JIRA connection details, click the Test JIRA 6.0+ Connection button.  If the connection between qTest Manager and JIRA is successful, the following message is displayed.

    Connected to server successfully.

  7. Click the Save and Configure button.   

    The Configure Connection page is displayed.  From this screen, you will configure defect integration with JIRA and then import requirements from JIRA.



    NOTE:  If you receive an error message after clicking the Save and Configure button, see the ‘Common Roadblocks’ section, below.


NEXT STEP
:

See the article Configure Defect Integration with JIRA.

Common Roadblocks

If the connection between qTest Manager and JIRA fails, here are some common errors and solutions.  

ERROR

SOLUTION

qTest Manager JIRA connection dialog box displays Index:0, Size: 0 error message.

Ensure the JIRA account to be used to integrate with qTest Manager has JIRA System Administrator Global Permissions assigned to it.  The account used for the integration must have permissions to create objects in JIRA that will be mapped to defects (e.g., issues, tasks, etc.).

qTest Manager JIRA connection dialog box displays Connection failed. Received fatal alert: bad_record_mac message.

This error message is displayed when this instance of JIRA uses SSL encryption.  Please contact our support team at support@qasymphony.com.  We will explore options with you to set up the integration while maintaining the security and integrity of the data in your JIRA instance.

On-Premise JIRA system crashes when setting up qTest for JIRA add-on

This error occurs when the JIRA On-Premise version is hosted by a 3rd party provider or hosting service, which will enact stricter time out limits on record retrievals.  We have packaged a separate connector that will resolve issues with this integration.  Please contact us at support@qasymphony.com and we will be happy to help you resolve this issue.

On-Premise JIRA to On-Premise qTest connection is successful, but cannot retrieve requirements into qTest

Reinstall qTest On-Premise. 

Issue Connecting from On-Premise JIRA to On-Demand qTest

This error is usually due to incorrect firewall settings.  Please open the firewall to the following IPs to allow qTest Manager to communicate with your OnPremise JIRA instance:

  • 54.83.56.253
  • 54.83.57.47
  • 54.83.57.78
  • 54.83.57.122
  • 54.83.57.143
  • 54.83.57.153

qTest Manager to JIRA integration fails due to "Invalid Credentials"

This error occurs when a customer uses a JIRA account that is validated by single sign on (Crowd).  We recommend that you create a new Admin account directly in JIRA, and use that for the qTest integration.








 

Subscribe To Our Blog
Powered by Zendesk