Jira Server SetupLast Updated: October 11, 2019
Our Jira integration requires a feature flag to be turned on. Please contact us, firstname.lastname@example.org or chat with us using the widget in the corner to get this feature turned on.
Step one: adding Halp IP addresses to your Amazon Jira DC Stack security group (optional, only applicable if you restrict access to your Jira instance)
Go to your security group settings in AWS, find your JiraDCStack group, and add the following IP addresses in CIDR notation:
All incoming API requests from Halp will come from one of these two IP addresses.
Step two: Add a Halp user to Jira and configure permissions
First, create a user for Halp to connect to Jira with. We recommend naming it in a way that makes it clear it’s not a normal user, for example “Halp Bot”.
Then, make sure the user is in the group “jira-servicedesk-users”.
Next, add the user to a project you want to sync Halp with and ensure that it is a member of the “Service Desk Team” role:
Step three: Set up an application link for Halp
Open administration settings and navigate to “Application links”.
Then, enter halp.com as the domain, press continue to ignore this warning:
On the next page, enter the following values:
The “na” is for “not applicable”, and you can enter it for all these parameters as our application does not make use of an outgoing link. However, ensure you check “Create incoming link”.
You should see this page:
Enter these values:
Consumer Key: halp-consumer-5z5HK4Eb
Consumer Name: Halp
Hit continue, and you should see the following:
Step four: set up a comment webhook.
From the Jira settings console, navigate to System > WebHooks.
Click “Create a webhook”, and you should see the following:
Enter the following values:
Name: Halp webhook
Leave events for “All issues” and check the boxes under “Comment” labeled “created”, “updated”, and “deleted”, as well as under Issue for "created", "updated", and "deleted."
Step five: Logging into Jira DC from Halp
*****Log out of your personal Jira user, and log in using your Halp Bot user.*****
Then log into Halp, go to Settings > Integrations, and add a new Jira Server integration from the dropdown.
Enter your Jira URL with the protocol but without a trailing slash, and hit authenticate.
On this page, click “Allow”.
You should see this, which means Jira server is ready to configure just like any other integration!