Skip to main content

Jira Server

This documentation provides step-by-step instructions on how to integrate TestFairy Connect with Jira Server for bug tracking. By following these guidelines, you can seamlessly connect TestFairy to your on-premise Jira Server either using basic authentication (user/password token) or OAuth.


To connect TestFairy to Jira Server that is installed on-prem, start by installing TestFairy Connect.

Using the Configuration Wizard

Start the wizard by typing the following command in your terminal or command prompt:

$ testfairy-connect configure

The Configuration Wizard will prompt you with the following questions:

  • What is your TestFairy API Key? Enter your Upload API key here; you can access it via the Settings Page.

  • What kind of issue tracking system will you use with TestFairy Connect? Choose JIRA.

  • What is your Jira URL (for example, Provide the URL address of your Jira server. Remember to include the http:// or https:// prefix.

  • How shall TestFairy Connect authenticate to JIRA? Choose basic.

  • What is the type of Jira issues to be created using TestFairy Connect? Choose the appropriate issue type used in your JIRA. JIRA uses Bug by default, but it varies on project type. Other examples are Defect or Task.

  • Jira username: Enter your JIRA login username.

  • Jira password: And your JIRA login password

  • Sometimes, depending on your user definitions in Jira, you may need to use an API token as your password. You can create one here.

  • Please enter HTTP proxy server address; leave empty if none: Send it here if you require an HTTP proxy to access this Jira server. For example, http://user@

Once you have provided all the necessary information, the configuration wizard will display a success message: Successfully connected to the issue tracker.

You have now successfully configured TestFairy Connect with Jira using basic authentication. Next, you can start the agent from the command line.

Configure Jira with OAuth

Access Token & Secret Generation:

  1. Obtain a key pair:

    openssl genrsa -out jira_rsa 2048
    openssl rsa -in jira_rsa -pubout >
  2. Configure Jira the Application Link for TestFairy Connect integration.

    1. In your browser, go to your Jira Admin page, like http://localhost:2990/jira/plugins/servlet/applinks/listApplicationLinks.

    2. Enter URL or any string to use for Application Link identification.

      Create an application link
    3. In the next screen, click Continue.

      ContinueSet Application link
      - Application Name: `TestFairy`
      - Application Type: `Generic Application`
      - Service Provider Name: `TestFairy`
      - Consumer Key: `testfairy-connect`
      - Shared Secret: `[paste public key contents here]`
      - Request Token URL: `/plugins/servlet/oauth/request-token`
      - Request Token URL: `/plugins/servlet/oauth/access-token`
      - Request Token URL: `/plugins/servlet/oauth/authorize`
      Verify access token
  3. Run the token generation script. Right-click to copy the .js file path.

    wget [paste file path here]
    npm install oauth
    node oauth.js
  4. Update your config.json with access_token and access_token_secret.

  5. (optional) Install the TestFairy Chrome Extension.

The TestFairy Chrome Extension is available at here. With this Chrome extension, every Jira issue that has a link to a TestFairy session will contain the proper TestFairy session, timeline, logs, and crash reports embedded in the Jira issue.