Last updated Nov 1, 2020

In this scenario we will show you how to set up a basic one-way synchronization between two JIRA Cloud instances:

Jira A
Jira B

The correct configuration order is presented below. Some actions need to be done in sequence.

Info

Deviniti’s Rovo Assistant provides access to a virtual assistant that helps you with configuration, installation, and troubleshooting, enabling quicker and faster navigation through documentation. See Deviniti’s Rovo Assistant documentation or find it on the Atlassian Marketplace for more information.

1. Connection Jira A setup

Go to Jira Administration > Apps > ISSUE SYNC > Configuration
Click +Add a connection button
Fill the form with Name and Remote URL of Jira B
Click Create button
Local Authentication Key has been generated for this connection

2. Connection Jira B setup

Go to Jira Administration > Apps > ISSUE SYNC > Configuration
Click +Add a connection button
Fill the form with Name, Remote URL of Jira A and set Remote Authentication Key with Local Authentication Key from Jira A
Click Create button
Local Authentication Key has been generated for this connection

3. Connection Jira A setup - update

Click Edit link on Connection A
Set Remote Authentication Key with Local Authentication Key from Jira B
Click Save button

Synchronization configuration (optional) To speed up configuration exchange between Jira instances:

Click Synchronize configuration link on Connection A
Sync status of the connection changes to IN SYNC

4. Contract Jira A setup

Click Contracts tab
Click +Add new contract link in Connection A section
Set Contract name
Click Save button
Click +Create button in Create/Update triggers section
Set Trigger name. Select Project Name and Issue type to determine issues synchronized from Jira A
Click Create button

Create trigger

Click +Create button in Create/Update triggers section
Set Trigger name. Select Project Name and Issue type to determine issues synchronized from Jira A
Click Create button

5. Contract Jira B setup

Click Contracts tab
Click +Add new contract link in Connection B section
Set Contract name
Click Save button
Click +Add link in Remote Contract field
Select Contract A
Click Incoming Configuration tab
Click +Create button in Issue incoming mapping section
Set Project Name and Issue Type to determine which issues will be synchronized. Select the trigger created in JIRA A in Remote triggers field
Click Create button

Incoming mapping setup

Click Incoming Configuration tab
Click +Create button in Issue incoming mapping section
Set Project Name and Issue Type to determine which issues will be synchronized. Select the trigger created in JIRA A in Remote triggers field
Click Create button

Exposed fields configuration

Click Edit button in Exposed fields to receive section
Click +Add link
Select Local field and set Exposed Field name (used in Jira A as a label)
Click +Add button
Perform addition operation for every field, that should be exposed to Jira A
Click Save button

6. Contract Jira A & Jira B binding

Click +Add link in Remote Contract field
Select Contract A

7. Fields to send configuration

Click Edit button in Fields to send section
Click +Add link
Select Local field and Remote Field name, that should be synchronized

Click +Add button
Perform addition operation for every field, that should be sent to Jira B
Click Save button

Trigger Config

Click +Add link in On which Jira event trigger create field
Select issue_created from the list
Click +Add link in On which Jira event trigger update field
Select issue_updated from the list

8. Enable Contract A & B

Click Contracts tab
Click Enable