Tools Connect: Jira

Allstacks pulls tickets, cards, stories, and other units of work from your project management tools such as Jira. We combine that with data about deliverables and milestones such as releases, epics, initiatives, and projects and activities such as estimation changes, completions, comments, and status updates to provide a very comprehensive picture of your work.

Allstacks service connection to Jira is established either via an API Token or OAuth. For short-term trials, we recommend using Jira(Basic) to connect using API token for ease of use. For production setup, Jira (OAuth) is preferred longer term.

Jira (Basic) - Connect using API token

• Before starting, confirm that you are actively signed into Jira with the account, preferably service account, you wish to connect to Allstacks.

  • Ensure appropriate Jira permission scopes for the project(s) targeted for the trial: Browse project, Assign Issues, Create Issues.

• Login to Allstacks, select Add Tools

• Assuming you are signed in to the Jira service account, when selecting “Get your API Token here” will open up a new tab. Create API Token in Jira, name it Allstacks, and paste it here.

• Verify the Atlassian site name and email address

• Click Add Tool button to connect.

Open

• On successful connection, you will see a list of resources you can toggle on and off that are repositories and projects, respectively. In the event this list is blank you may need to press “Refresh Resources”.
  
  

  Open

  

Jira (OAuth)

Alternatively, you may connect to Jira using OAuth service connection.

You can find your site name by looking at the url for Jira e.g https://{SITE NAME}.atlassian.net/
Jira OAuth integration must be performed by a JIRA site admin. It requires a few additional steps compared to a typical OAuth service. You will need to create an custom application link for Jira.

1. Navigate to the Tools page in Allstacks, then click Add Tool -> Jira (OAuth).

2. Fill in your Jira base URL.

   1. Example: my-org.atlassian.net for Cloud or jira.example.com for on-prem Jira Server / Datacenter.

3. Click the Generate Keys link. Make note of the Consumer Key, Public Key, and the callback URL at the bottom of the form that ends in /service/JiraConnector/auth-finish.

4. Navigate to the App Link configuration in the Jira admin section.

   1. For Cloud, navigate to Settings Menu -> Products -> Application Links.

   2. For Server, navigate to Settings Menu -> Applications -> Application links.

5. Create a new link. For the Application URL, specify the Allstacks instance URL hosting your tenant.

   1. Example: https://app.allstacks.com or https://MY-ORG.allstacks.com for single tenant environments.

   2. For Jira Cloud, specify Direct application link.

   3. You may receive an error stating No response was received from the URL you entered. This can be ignored, just click Continue.

6. In the Review Link modal, provide a descriptive Application Name, such as Allstacks, then click Continue.

7. In the list of applications, open the context menu for the newly created entry and click Edit -> Incoming Authentication.

8. Fill in the Consumer Key, Public Key, and Consumer Callback URL with the values that you copied from the Allstacks tool connection modal earlier. For Consumer Name, you can use the same name you used for the Application Link. Click Save.

9. Back on the Allstacks tools connection page, click Add Tool. This will navigate you through the OAuth authorization process. Click Allow when prompted by Jira.