diff --git a/docs/organizations/images/jira-create-webhook.png b/docs/organizations/images/jira-create-webhook.png new file mode 100644 index 00000000000..f0f49282d44 Binary files /dev/null and b/docs/organizations/images/jira-create-webhook.png differ diff --git a/docs/organizations/jira-faqs.md b/docs/organizations/jira-faqs.md index 21bc856ed0a..2da3250f90f 100644 --- a/docs/organizations/jira-faqs.md +++ b/docs/organizations/jira-faqs.md @@ -18,3 +18,4 @@ I don't want to give this integration permission to view all my Jira projects. C Why is that after installing the Jira Cloud add-on, Jira is giving me the following error: `App is not responding`? | The plugin is trying to redirect you to HackerOne's website to finalize the setup. However, some browsers are blocking redirects and the plugin won't be able to redirect you. If this happens, try installing the plugin with a different browser. How come I'm not seeing the option to create a Jira issue on the report? | You can only escalate a report to Jira if you have the right permissions. You will need "Report Management" permissions in order to escalate a report to Jira. What do I do if I don't see the issue type I need listed? | To make sure you can select the right issue types for your integration, you need to meet these 2 requirements:

1. You have the proper permissions to see the issue type.
2. The issue type is [associated](https://confluence.atlassian.com/adminjiraserver/associating-issue-types-with-projects-938847092.html) with the project you selected.

Issue types are fetched based on the linked project, and even though not all issue types will be supported, all available issue types that are linked and can be viewed by the authenticated user will show. + I have configured events from Jira to HackerOne, but why are they not synchronizing? | To synchronize events from Jira to HackerOne a webhook must be configured in Jira. This webhook will be automatically created in your Jira instance during setup. If for some reason the creation of the webhook fails you can [create a webhook manually](https://developer.atlassian.com/server/jira/platform/webhooks/).

You can find the `URL` for the webhook in the configuration wizard. Set the `Scope` of the webhook to the Project and Issue type configured during the setup. Set the events to `Issue updated` and `Comment created`.

![jira-create-webhook](./images/jira-create-webhook.png) diff --git a/docs/organizations/jira-setup.md b/docs/organizations/jira-setup.md index eb24636c7dd..bfd356acc08 100644 --- a/docs/organizations/jira-setup.md +++ b/docs/organizations/jira-setup.md @@ -115,7 +115,7 @@ Comment added | Post an internal comment when someone comments on an issue. ![jira-setup-13](./images/jira-setup-13.png) -19. (Optional) Once you complete this integration, a Jira webhook will be automatically created in your Jira instance. If there is no webhook created, you can use this Webhook URL to create a webhook manually with the Issue Updated and Comment Created events. +19. (Optional) Once you complete this integration, a Jira webhook will be automatically created in your Jira instance. If there is no webhook created, you can use this Webhook URL to [create a webhook manually](/organizations/jira-faqs.html#jira-create-webhook) with the Issue Updated and Comment Created events. ![jira-setup-15](./images/jira-setup-15.png)