This document walks through step-by-step instructions to set up your JIRA integration.

Set up JIRA fields

In order to properly post issues to JIRA, the following fields must be enabled for your desired project:

  • Issue Type
  • Summary Description

In addition, any fields other than those above can not be configured as required fields.

Set up a Rainforest Application Link

To set up Rainforest as an Application Link you will need JIRA admin access for the menu below to appear and to use it. If you do not see Application Links in your JIRA instance, contact your JIRA admin.

1. From the main view of JIRA click on the settings Gear and choose “Products” from the modal:

2. Click on “Application Links”

3. Enter “https://www.rainforestqa.com/” into the field and hit enter

4. Click “Continue”

5. Enter any name for the application and click “Continue”

6. Viewing a list of your application links, click on the pencil to the right of your link to edit

7. Select “Incoming Authentication”

8. Enter “WjEUyzd78JaUeGgYWrDZNw” for the Consumer Key

9. Enter any name for Consumer Name

10. Enter the following for the Public Key:

-----BEGIN PUBLIC KEY-----MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA4edeTLpAi2vLpOPYMtyN53RktN8qIMXNuSacUJazjiBRCIfOmbm1zIlxTvTKnHN+eEWhTSbJzEobA16lBQnB4qmQL0sNmkUPrYHhAytyvBy1rcK1RWIe5ak1Je0opHx9D3QvVIKyOoRsL5trfOV91znPrO69PVNci+X/z2fEWeZSnLdqEG75KgVdQzGaaSGIo5DFz66WBG0RmCsFMTYrsi1ZhmFBLjiD7wXFJj76KF5nQpTeNJq1Grpy/QXg+vt65u0TPrq+6wa3TLOJCEX8VT5eNtfqUmWT3Bka6YOzs7UJQu2lIFIagQmbtj/Fs5lkVa2O5Escv0vP2gAGqiFjWwIDAQAB

-----END PUBLIC KEY-----

11. Click “save”

12. Go to your Rainforest Settings > Integrations Page and start a new Test Failure integration

13. Enter the project key from your project (found in the main JIRA view in the Key column)

14. Enter the URL to your JIRA project

15. In OAuth Server URL place the same URL as in step 14

16. Click Approve Access

  • Note, you must be logged into both JIRA and Rainforest as an administrator

17. Click “Allow” on next window

18. Back in your Rainforest settings page, click “Test Webhook” within your JIRA integration to test that there are no errors.

Notes:

  • The URL you input for the "Oauth Server URL" is often the same URL as the one you input for "URL to your JIRA integration"
  • For the "Request Token Path", "Authorization" Path and "Access Token" Path fields, input the path only; you do not need to include a full URL.
  • If you have questions, please reach out to support@rainforestqa.com
Did this answer your question?