Jira Server Setup

Halp can integrate with Jira Data Center (and Jira Server) to sync issues bi-directionally between Slack and Jira. Follow these instructions to setup the integration.

Not sure if you're using Jira Server, Jira Data Center, or Jira Cloud? If your Jira URL ends in atlassian.net or jira.com you're using Jira Cloud and you should follow these instructions instead. If your URL is something else, these are the instructions for you!

  1. Allow Halp to communicate with your Jira instance

If your Jira instance isn't accessible from the internet you'll need to allow Halp through your firewall. Halp will send requests from these two IP addresses:

  • 54.175.230.252/32
  • 54.173.229.200/32

If your Jira instance is open to the internet you can skip this step.

  1. Add a service account user for Halp

We require you to create a user for Halp to connect to Jira. 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:

  1. Configure webhooks

Halp uses webhooks to receive updates that happen in Jira, like comments or status changes. To add a webhook for Halp:

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

Status: Enabled

URL: https://halp.com/integrations/jiraserver/comment-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."

 

  1. Authenticating Jira to Halp (Basic Auth)

Halp recommends using Basic Auth to connect Halp to Jira. Alternatively you can use oauth, but this will prevent you from limiting which Jira projects Halp can see and requires additional configuration.

Click 'Basic Auth' radial button and complete Username & Password form

  1. Set up a Halp Recipe to route tickets.

On this page, click “Allow”.

You should see this, which means Jira server is ready to configure just like any other integration!

Known Issues

  • If your Jira Server instance is behind a proxy you might need additional configuration to enable features like sending Jira tickets to Halp. Please contact support@halp.com for more information.

(Deprecated) Integrate to Jira Server with OAuth

Halp can alternatively integrate to Jira Server with OAuth 1.0. We do not recommend this method, as it gives you less control over what Halp has access to and does not provide any extra benefits.

  1. Follow steps 1-3 above.

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

Public Key:

MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDEOZvll7xoOIIKqlJEJ2i6aF3b8lernesp1edCNBVFtIK48vcEUBFpM3mcJm0ezt+w/vq/lVhKp2Ckm0uDZNFqIDmEKGobWUH/Sx2l1OvDnnVyO/UHG6LEbAdLzfO9cX+wj/0AxQ2rkHJTJXK5YxXxKRqnB7Tej9wlQMVmXRLshQIDAQABB7Tej9wlQMVmXRLshQIDAQAB

 

Hit continue, and you should see the following:

  1. Authenticate

*****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.

  1. Complete step 6 to finish integrating.


How did we do?


Powered by HelpDocs (opens in a new tab)