10X: Jira Integration Prerequisites

Supported Jira versions

The connector supports all Atlassian-supported Jira Software versions. See the Atlassian Support End of Life Policy for a full list of supported Jira Software versions. 

Jira server information

Question

Answer

1. Is your Jira instance accessible over the Internet? (*see below if No)

 Yes/No

2. Does the Jira server have a publicly trusted SSL certificate? (https) (**see below if No)

 Yes/No

3. What is the URL to access Jira Software?

 Fill in the URL ___________________________________ 


* If both Jira Software and Jira Align are planned to be on site behind the firewall, then a VPN access for both the Jira Align engineer and the solutions architect is required. If no VPN access is provided to the Jira Align team, there is an additional license fee.

** You must obtain a publicly trusted SSL certificate from a certificate provider and install it on the Jira Software Server.

Jira user and project prerequisites

1. Create a Jira Software user specifically for the integration process and provide the user name and password to your assigned solutions architect. The user must have the following project permissions on all Jira Software projects that you plan to synchronize to Jira Align:

  • Administer projects
  • Browse projects
  • Manage sprints
  • Assignable user
  • Assign issues
  • Close issues
  • Create issues
  • Edit issues
  • Link issues
  • Modify reporter (if you consolidated the Create and Edit Jira Software screens)
  • Resolve issues
  • Schedule issues
  • Transition issues
  • Add comments

Additionally, the user must have the Browse Users and Groups global permission enabled in Jira.

Note: If your Jira instance includes users in languages other than English, ensure that your Jira service user's language setting is set to English (US or UK) in Jira, and do not use Jira user translations for issue type field values so that they match the default Jira issue type names (Epic, Story, etc.)

2. Ensure that each Jira project and its issues meet the following criteria:

  • Both the Create Issue and Edit Issue screens have the Jira Story Points field editable by the Jira Align user account.
  • When a work item's state changes, the Jira Software workflow is configured to only require a reason for changing the state and no other fields are required. This is needed for the proper bidirectional syncing of state for stories and features (epics in Jira Software).
  • To ensure project-specific mappings are correct, refer to the Jira Software API call below. Jira Administrators, replace "mycompany.atlasssian.net" with the URL for your Jira Software instance and replace "CON-79" issue key with an issue key ID from the project(s) that will be integrated with Jira Align.

https://mycompany.atlassian.net/rest/api/latest/issue/CON-79/transitions?expand=transitions.fields

API URLs for Jira connector

These are the four API-based URLs that the Jira connector requires.

/rest/auth/

/rest/api/2/

/rest/agile/1.0/

/rest/greenhopper/1.0/

The documentation for the above APIs can be found here:
https://docs.atlassian.com/jira-software/REST/server/
https://docs.atlassian.com/jira-software/REST/cloud/

 

Was this article helpful?
0 out of 0 found this helpful
Print Friendly Version of this pagePrint Get a PDF version of this webpagePDF

Join the Atlassian Community!

The Atlassian Community is a unique, highly collaborative space where customers and Atlassians come together. Ask questions and get answers, start discussions, and collaborate with thousands of other Jira Align customers. Visit the Jira Align Community Collection today.

Need to contact Jira Align Support? Please open a support request.