title: "Jira Setup"

path: "/programs/jira-setup.html"

id: "programs/jira-setup"

You can integrate with Jira in order to sync information between your HackerOne report and your Jira issue.

To integrate with Jira:


3. Click the **Set up new integration** button.

4. Enter **Name** and **Description** for your new integration and click **Next.**


6. Enter https://hackerone.com and click **Create new link.**

7. Enter https://hackerone.com in the New URL field in the Configure Application URL window.

8. Enter the following information on the Link applications window and click **Continue.**

Fields | Details

------ | -------

Application Type | Generic Application

Service Provider Name | HackerOne

Consumer key | HackerOne JIRA Client

Shared secret | Enter any string and save it for later use (case-sensitive).

Request token URL | https://hackerone.com

Access token URL | https://hackerone.com

Authorize URL | https://hackerone.com

Create incoming link | Check the checkbox


9. Enter the following information on the next **Link applications** window:

Fields | Details


10. Click **Continue.**

11. Navigate back to HackerOne and click **Add a new account** in the Jira authentication window.

12. Enter your Jira instance URL and the shared secret from step 8 in the **Create a new authentication window** and click **Create.**


13. Click **Next** to finalize the setup between HackerOne and your Jira instance.

14. Configure which Jira project and issue type you'd like to escalate HackerOne reports to in the **Jira project and issue type** window and click **Next.**


15. Select the Jira fields you want to map to the corresponding HackerOne fields and click **Next.** Note: only supported Jira field types are shown.


16. *(Optional)* Select Jira Priorities you want to map to the corresponding HackerOne Severities. This enables the right priority to be set when escalating a HackerOne report to Jira.


17. *(Optional)* Select which actions in HackerOne you'd like to post to Jira in the **Select HackerOne to Jira events** window. You can choose from:

State changes | When someone changes the state of a report, post an update on the associated Jira issue.

Assignee changes | When someone assigns a user/group to a report, post an update on the associated Jira issue.


18. *(Optional)* Select which Jira actions you'd like to post onto HackerOne in the **Select Jira to HackerOne events** window. You can choose from:

Option | Detail

------ | -------

Status changed | Post an internal comment when an issue changes status.

Resolution changed | Post an internal comment when an issue changes resolution.

Closed issue status | Resolve the report when an issue is closed with the selected status.

Priority changed | Post an internal comment when an issue changes priority.

Assignee changed | Post an internal comment when an issue changes assignee.

Comment added | Post an internal comment when someone comments on an issue.


If you have multiple HackerOne programs, you can integrate them to the same Jira instance. Follow steps 11-18 for each subsequent program you need to add an integration for.

*Note: You only need to follow steps 11-18 for your other programs because the application link has already been created when integrating with your first program, and only 1 application link is needed to set up a Jira integration.*

If you want to integrate the same program to multiple Jira instances, you can follow all the steps above for each integration.

- title: Jira Setup

path: /programs/jira-setup.html