Create
cancel
Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

Next challenges

Recent achievements

Recognition

  • Give kudos
  • My kudos

Leaderboard

  • Global

Trophy case

Kudos (beta program)

Kudos logo

You've been invited into the Kudos (beta program) private group. Chat with others in the program, or give feedback to Atlassian.

View group

It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

Jira Align to Jira Server/Data Center Connectivity - Quick Guide

This article is designed to get Jira Align to Jira Server/Data Center connectivity up and going quickly.

 

Prerequisites:

  • You have access to Jira Align as a Super Admin or you are Admin of the Jira Connector we are configuring.
  • You have configured and have access to the Service Account in Jira. 

 

1) In Jira Align, click on the Administration Gear in the bottom left.

 

2) Click on Connectors > Jira Settings in the second column.

_1.png

 

3) Click on the Jira Connectors button in the main pane.

_2.png

 

4) Fill out the Jira Connector as follows:

_3b.png

  • Jira Link: https://<your JIRA Base URL>/browse/{external}
  • Name: Anything descriptive. This is a vanity name only.
  • Admins: Add any other Jira Align users that you want to manage this connector that are not Super Admins.
  • Jira API URL: https://<your JIRA API URL>
    • Note: If you are using a Proxy or API Gateway, this will be different from the Jira Link.
  • Authentication Type: OAuth 1.0 Authentication (highly recommended)
    • Note: If you are unable to use OAuth 1.0, you can skip the OAuth section later in this document and opt to use Basic Auth with the Jira Service Account username and password.
  • Jira OAuth Consumer Key: Anything descriptive. Remember this Consumer Key for later.
    • Note: Do not use spaces or symbols for the Consumer Key!

 

5) Once the above has been filled out, click Generate New Key and copy it to your clipboard.

  • Note: Some browsers have issues copying this block of characters so you may have to try a few times to get it in the clipboard. I've also found resizing the text box and then copying helps as well.

 

6) Click Save at the bottom of the Connector window.

 

7) Login to Jira, click the Settings cog in the top right, and select Applications.

Note: Alternatively, you can click on any whitespace in Jira and press "." and search for Application Links. 

 _16.png

 

8) On the left column, under Integrations, click Application Links.

_17.png

 

9) Enter the Jira Align URL (https://__.jiraalign.com) in the field and click Create New Link.

_18.png

 

10) Jira Server/Data Center may complain there was no response. Just click Continue.

_7.png

 

11) Fill out the Application Name with something descriptive.

_8b.png

 

 

12) Click the Pencil to edit the newest application.

_9.png

 

13) Fill out the Consumer Key with the same one used in Step 4. 

_10.png 

 

 

14) Paste the OAuth Public Key you copied from Step 5. 

_11.png

 

15) Scroll down and click Save.

 

16) Go back to the Jira Align Connector window from step 4.  

 

17) Click Authorize Jira OAuth Access.

Screen Shot 2020-10-13 at 10.39.35 PM.png

Note: You will see this request go through 3 steps and will refresh several times. It will take a few minutes for this process to complete.

Screen Shot 2020-10-13 at 10.39.40 PM.png

Note: If you are having trouble with this step, make sure that the Consumer Key matches on both sides and contains no spaces or symbols.

In addition, check that the OAuth Public Key are an exact match on both sides.

Lastly, make sure that the Application URL configured in the Jira Application Link is correct without any typos.

 

18) Once the OAuth access setup has completed, click Request Jira for access.

Note: Make sure you are logged into Jira Server/Data Center as the Jira Service Account in another tab of the same browser.

Screen Shot 2020-10-13 at 11.00.52 PM.png

 

19) You'll be taken to another tab asking you to allow the application to have access. Click Allow.

_15.pngScreen Shot 2020-10-13 at 11.09.53 PM.png

 

20) This is how OAuth in Jira Align will look when the process is completed:

Screen Shot 2020-10-13 at 11.21.37 PM.png

 

21) Click Save on the bottom of the Connector window.

 

22) One final test to confirm connectivity is the Test Now button at the bottom of the Jira Connector window. You may need to scroll down to see it.

Note: This test doesn't automatically refresh like OAuth did so you'll need to close and reopen the connector window periodically. This test also takes a few minutes to complete.

Screen Shot 2020-10-13 at 11.15.10 PM.png

Screen Shot 2020-10-13 at 11.23.00 PM.png

Screen Shot 2020-10-13 at 11.24.55 PM.png

 

23) Click Activate on the bottom of the Connector window.

 

24) Now that you are connected, you can sync a test project. 

 

Additional related articles:

10X Jira Integration Setup 

 

2 comments

Hi @James McCulley Step 7 - what version of Jira are you using please (because that doesn't appear to be the instructions for Jira server/DC incl. the latest LTS release 8.13)? It looks like you have reused the instructions from Jira Cloud not Jira DC. Clicking the cog looks like this: 

 Capture1.PNG 

Jira on-prems would need to click Applications > Application links

Like James McCulley likes this

Hey @Karalee Kikiros. Thanks for the comment. I was able to make the correction to the article. Nice catch!

Comment

Log in or Sign up to comment
TAGS
Community showcase
Published in Jira Align

Best Practices in Jira Align

Hello Jira Align customers! In order to better serve you on your journey with Jira Align, the Community team has worked with the Jira Align team to curate the content in this collection to better s...

401 views 0 11
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you