You can integrate with Linear to sync information between your HackerOne report and your Linear issue.
To integrate with Linear:
Go to Program Settings > Program > Integrations.
Click the Connect with Linear link.
Click the Set up new integration button.
Enter the Name and Description for your new integration and click Next.
Navigate to the Linear API settings in Linear by going to Settings > API and adding a new Personal API key.
Copy the generated key and save it somewhere. This key is shown only once.
Navigate back to HackerOne and click Add a new account in the Linear authentication window.
Enter your API key from step 6 in the Create a new authentication window in the Master token field and click Create.
Configure which Linear Team and Project (optional) you'd like to escalate HackerOne reports to in the Linear Team and Project window and click Next.
Select the HackerOne fields you want to map to the corresponding Linear fields. Alternatively, enter any text using integration variables. Click Next.
Note: You can manually set the mapping to a single field or combination of fields from the integration variables. For example:
{{triage_summary}} \\ Link: {{report_link}} \\ Date: {{submission_date}} \\ Reporter: {{reporter_name}} \\ Weakness: {{weakness}}would create a combination of the triage summary, a link to the report, the submission date, the reporter name, and the weakness of their report and map that to a single field.
(Optional) Select the Linear Priorities you want to map to the corresponding HackerOne Severities. This enables the right priority to be set when escalating a HackerOne report to Linear. Click Next.
(Optional) Select which actions in HackerOne you'd like to post to Linear in the Select HackerOne to Linear events window. You can choose from:
Comment added: When someone comments on a report, post an update on the associated Linear issue.
State changed: When someone changes the state of a report, post an update on the associated Linear issue.
Reward changed: When someone awards or suggests a bounty and/or bonus, post an update on the associated Linear issue.
Assignee changed: When someone assigns a user/group to a report, post an update on the associated Linear issue.
Disclosure: When disclosure is requested or a report becomes public, post an update on the associated Linear issue.
Click Next.
(Optional) Select which Linear actions you'd like to post onto HackerOne in the Select Linear to HackerOne events window. You can choose from:
Status changed: Post an internal comment when an issue changes status.
Closed issue status: Resolve the report when an issue is closed with the selected status.
Comment added: Post an internal comment when someone comments on an issue.
Assignee changed: Post an internal comment when an issue changes assignees.
Priority changed: Post an internal comment when an issue changes priority.
Click Next.
(Optional) If you have configured Linear actions to be synchronized to HackerOne in step 13, you need to configure a webhook in Linear. Copy the Webhook Public URL that is shown in the Workflow URLs screen.
Navigate to the API settings in Linear by going to Settings > API and creating a new Webhook.
Give the webhook a descriptive label and enter the Webhook Public URL into the URL field.
Save the Signing secret for use later.
Check the Issues and Issue comments events in the Data change events section.
Finally, set the Teams to Custom, and select only the team you selected in step 9.
Click Create webhook
Copy the Signing Secret into the Linear webhook secret field.
Click Finish. Once the screen disappears, click Enable to enable the integration.
You're all set! Now that you've finished setting up the Linear integration, you can create Linear issues right from your HackerOne report.
Multiple Integrations
If you have multiple HackerOne programs, you can integrate them to the same Linear instance. Steps 5-6 can be omitted for each subsequent program you need to add an integration for.
Multiple Linear Instances per Program
This feature is available for Enterprise programs only.
If you want to integrate the same program to multiple Linear instances, you can follow all the steps above for each integration.