You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/programs/jira-integration.md
+12-1Lines changed: 12 additions & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -46,7 +46,7 @@ To link your reports:
46
46
47
47

48
48
49
-
The HackerOne report will now be linked to the Jira task, and all activities that are performed on the report will be synced to the corresponding task.
49
+
The HackerOne report will now be linked to the Jira task, and all activities that are performed on the report will be synced to the corresponding task.
50
50
51
51
There's also another way you can link your HackerOne reports to Jira. You can:
52
52
1. Go to the bottom of your HackerOne report.
@@ -56,3 +56,14 @@ There's also another way you can link your HackerOne reports to Jira. You can:
56
56
57
57
3. Enter the JIRA ticket number in the **Enter JIRA ticket #** field.
58
58
4. Click **Link JIRA issue**.
59
+
60
+
### Creating a Jira Issue
61
+
You can create new Jira issues for reports you receive in HackerOne.
62
+
63
+
To create a new Jira issue from your HackerOne report:
64
+
1. Go to the HackerOne report in your inbox that you want to create a new Jira issue for.
65
+
2. Click **Edit** next to <i>References</i>.
66
+
3. Click **Create JIRA issue**.
67
+
4. Select the project that you want the issue to link to in the dropdown. *Note: This option occurs only if you have multiple projects to select from. If you only have 1 project, the issue will automatically escalate to that project.*
HackerOne offers a bi-directional Jira integration that syncs information between your HackerOne report and the Jira issue. You can choose to integrate with Jira Cloud or Jira Server.
7
+
HackerOne offers a bi-directional Jira integration that syncs information between your HackerOne report and the Jira issue. You can choose to integrate with Jira Cloud or Jira Server.
8
8
9
9
To integrate with Jira Server:
10
10
1. Go to **Settings > Program > Integrations**.
@@ -15,16 +15,16 @@ To integrate with Jira Server:
15
15

16
16
17
17

18
-
19
-
4. Navigate to the Application Links console of JIRA by going to **JIRA Administration > Applications > Application Links**.
18
+
19
+
4. Navigate to the Application Links console of JIRA by going to **JIRA Administration > Applications > Application Links**.
20
20

21
-
5. Enter `https://hackerone.com` and click **Create new link**.
21
+
5. Enter `https://hackerone.com` and click **Create new link**.
22
22

23
-
6. Enter `https://hackerone.com` in the New URL field in the Configure Application URL window.
23
+
6. Enter `https://hackerone.com` in the New URL field in the Configure Application URL window.
24
24

25
-
7. Enter `HackerOne` for the Application Name and select `Generic Application` in the Link applications window and click **Continue**.
25
+
7. Enter `HackerOne` for the Application Name and select `Generic Application` in the Link applications window and click **Continue**.
26
26

27
-
8. Select the pencil icon for HackerOne on the Configure Application Links page.
27
+
8. Select the pencil icon for HackerOne on the Configure Application Links page.
28
28

29
29
9. Enter the following information on the Application Details section of the Configure HackerOne window:
30
30
@@ -41,16 +41,18 @@ Field | Details
41
41
----- | --------
42
42
Consumer Key | HackerOne JIRA Client
43
43
Consumer Name | HackerOne
44
-
Public Key | Copy and paste from the key given.
44
+
Public Key | Copy and paste from the key given.
45
45
46
46

47
47
48
-
11. Click **Save**.
49
-
12. Navigate back to HackerOne and enter the URL of the Jira instance you want to authenticate with in the **Instance base URL** field in the **Configure an Application Link** step.
48
+
11. Click **Save**.
49
+
12. Navigate back to HackerOne and enter the URL of the Jira instance you want to authenticate with in the **Instance base URL** field in the **Configure an Application Link** step.
50
50

51
-
13. Click the **Authenticate with JIRA** button to finalize the setup between HackerOne and your Jira instance.
52
-
14.*(Optional)* Configure which HackerOne reports you'd like to escalate to Jira in the **Configure HackerOne to JIRA escalation** window.
53
-

51
+
13. Click the **Authenticate with JIRA** button to finalize the setup between HackerOne and your Jira instance.
52
+
14.*(Optional)* Configure which HackerOne projects you'd like to escalate to Jira in the **Configure HackerOne to JIRA escalation** window.
53
+
* Select the **Allow me to select a project every time when I escalate an issue** checkbox to have the ability to select from multiple projects when creating Jira issues.
54
+
55
+

54
56
55
57
15.*(Optional)* Select which Jira actions you'd like to post onto HackerOne in the **Select JIRA to HackerOne events** window. You can choose from:
56
58
@@ -60,10 +62,10 @@ Status changed | Post an internal comment when an issue changes status.
60
62
Resolution changed | Post an internal comment when an issues changes resolution.
61
63
Priority changed | Post an internal comment when an issue changes priority.
62
64
Assignee changed | Post an internal comment when an issue changes assignee.
63
-
Comment added | Post an internal comment when someone comments on an issue.
65
+
Comment added | Post an internal comment when someone comments on an issue.
64
66
65
67

66
-
68
+
67
69
16.*(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:
68
70
69
71
Option | Detail
@@ -72,8 +74,8 @@ Comments | When someone comments on a report, post an update on the associated J
72
74
State Changes | When someone changes the state of a report, post an update on the associated Jira issue.
73
75
Rewards | When someone awards or suggests a bounty and/or bonus, post an update on the associated Jira issue.
74
76
Assignee Changes | When someone assigns a user/group to a report, post an update on the associated Jira issue.
75
-
Public Disclosure | When public disclosure is requested or a report becomes public, post an update on the associated Jira issue.
77
+
Public Disclosure | When public disclosure is requested or a report becomes public, post an update on the associated Jira issue.
76
78
77
79

78
80
79
-
You're all set! Now that you've finished setting up the Jira integration, you can create Jira issues right from your HackerOne report.
81
+
You're all set! Now that you've finished setting up the Jira integration, you can create Jira issues right from your HackerOne report.
0 commit comments