1. Betterworks
  2. Betterworks
  3. Integrations

Integrations: Jira (Administrators)

Contents

Overview

Note: For information on how your team can use the Jira integration, see this article.

As an administrator, managing workflows and ensuring productivity across your team is crucial. With the Betterworks Jira integration, you can seamlessly integrate your Jira workflow into your milestone tracking in Betterworks. By linking Jira issues to milestones in Betterworks, you can increase transparency and accountability, enabling you to make data-driven decisions, track overall progress, and drive success. 

Anyone who uses Jira to track tasks, features, or projects in their workflow can benefit from this integration. For instance, engineers often use it to show bugs that they have to squash, while product managers use it to track the shipment of features by setting up a JQL query to capture overall progress.

Setup

Atlassian-hosted Jira instances (Admin level access)

  1. Go to the Admin module.
  2. Select the "Platform Configuration" tab.
  3. Scroll down on the left-side panel to "Third-party integrations."
  4. Scroll down on the page to "Jira."
  5. Click "Set Up."


     
  6. Toggle the integration on.


     
  7. Leave the option on "Admin."
  8. Click "Cancel."


     
  9. Enter an instance name.
  10. Enter the applicable username (email address).
  11. Briefly go to Jira to generate an API token.
  12. Come back to Betterworks and enter the API token as the password.
  13. Enter the applicable Jira host URL.
  14. Click "Create." 

Atlassian-hosted Jira instances (User level access)

  1. Go to the Admin module.
  2. Select the "Platform Configuration" tab.
  3. Scroll down on the left-side panel to "Third-party integrations."
  4. Scroll down the page to "Jira."
  5. Click "Set Up."


     
  6. Toggle the integration on.


     
  7. Select the "User" option.
  8. Click "Confirm."



  9. When User level access is enabled, users must grant Betterworks access to their Atlassian account before connecting a milestone to any Jira issues. 






On-premises Jira Instances (Admin level access)

  1. Go to the Admin module.
  2. Select the "Platform Configuration" tab.
  3. Scroll down on the left-side panel to "Third-party integrations."
  4. Scroll down the page to "Jira."
  5. Click "Set Up."


     
  6. Toggle the integration on.


     
  7. Leave the option on "Admin."
  8. Click "Cancel."


     
  9. Enter an instance name.
  10. Enter the applicable username (email address).
  11. Enter the applicable password.
  12. Enter the applicable Jira host URL. 
    Note: If the Jira instance is behind a firewall, your organization's IT Team will need to open a port so that Betterworks can access it. Once the port has been opened, include the port number at the end of the URL (i.e., https://Jira.company.com:1234). Your organization's IT Team may also need to allow the following Betterworks IPs to the firewall's safelist (18.235.225.62/32, 54.198.90.129/32, and 54.237.162.217/32).
  13. Click "Create." 

Troubleshooting

If you encounter any issues while setting up the Jira integration, here are some troubleshooting steps you can take:

  1. Log out of Betterworks, then log back in and try to connect a milestone to a Jira issue.
  2. Check that the API token linked to the Jira instance is correct and has not expired.
  3. Check that you added "https" to the Jira host URL.
  4. Check that the credentials for the JIRA user account are up-to-date.

FAQs

Is it possible to add multiple instances of Jira in the integration if my organization is using multiple instances?

Yes. You can add multiple instances from the Jira section of the Third-party integrations page. However, you may need to log out of Betterworks, then log back in again to see the change reflected.