Skip to main content
Skip table of contents

Create a Synchronization

Backbone Issue Sync allows you to integrate two Jira projects to synchronize issues.

Scope of a synchronization

Synchronizations are always configured on a project-by-project basis, always between two projects.

However, you can create multiple synchronizations per project. So if you want to connect one project with multiple projects, you can simply create multiple synchronizations for a project.

Data transmission protocol

Backbone uses the official Jira REST API in order to access both Jira projects which it integrates. If you provide a HTTPS URL when you setup the synchronization, Backbone will use an encrypted channel in order to communicate with JIRA.


Configuration

You have multiple options to sync from your cloud project, you can synchronize:

Synchronize two Jira projects on the same instance 

  1. Firstly, open the project that you want to synchronize, and select Project settings > Issue synchronization > New Synchronization > Synchronize with another project on this instance:

  2. Choose the project you want to synchronize issue data with, then click Next

  3. Assign a name and description. For now, let's stick with the default name and description – just click Next

  4. On the settings overview screen, check the configuration settings then click Send Request

  5. Now, any user with the Administer Projects permission for Cloud Project B can accept the synchronization request to establish the connection between the projects. To accept the request, open Cloud Project B and click Project settings > Issue synchronization > in the Actions column, click ... > View Request > Accept Request.

Congratulations, you've established a synchronization! Now, carry on and configure what issue types will be synchronized between the projects.

Synchronize two Jira projects on different instances 

To sync with a project on another instance, you need to send a 'Synchronization request' to the other instance, which the Jira administrators in the other instance can accept to establish a connection.

  1. Open the project you want to synchronize, and select Project settings > Issue synchronization > New Synchronization > Synchronize with another Cloud instance > Next:

  2. In the Partner Instance column, enter the following data:

    1. In the Base URL field, enter the base URL of the Jira instance you want to synchronize with – it will have this structure: https://example.atlassian.net

    2. In the Project Key field, you can enter a specific project key of a project in the partner instance. Enter Cloud Project B's project key, and click Next

  3. Based on your needs, either choose “immediate“ or “review“, and click Next

  4. For now, let's stick with the default name and description – just click Next

  5. Check the configuration settings, and click Send Request

  6. Now, any user with the Administer Projects permission for Cloud Project B can accept the synchronization request to establish the connection between the projects. To accept the request, open Cloud Project B and click Project settings > Issue synchronization > in the Actions column, click ... > View Request > Accept Request

Congratulations, you've established a synchronization! Now, carry on and configure what issue types will be synchronized between the projects.

Synchronize from Cloud to Data Center

Prerequisites

To set up a sync from Cloud to DC you need the following:

  • Project admin rights cloud

  • A sync user on Data Center

  • Jira 8.22 or higher on Data Center

Step 1 - Cloud: Create a Sync

  1. Go to the project that you want to synchronize on Cloud

  2. Select Project settings > Backbone Issue Sync > New Synchronization > Synchronize with a Data Center Instance

  3. Copy the URL provided

On the Data Center instance you want to sync with, create an application link

You only need to set up the application link once. Thus if you want to set up multiple synchronizations to the same instance, you can use the same application link and skip this step

  1. Go to the cog icon (Settings) > Applications.

  2. Select Application Links in the left menu.

  3. Select Create link:

    1. For Application type, select External application

    2. For Direction, select Incoming

  4. Click continue

  5. Fill out the form:

    • Name: give it a unique name, e.g. Backbone Authentication

    • URL: copy the URL provided in the create sync dialog (on cloud)

    • Permission: choose Admin

Admin permissions are needed for project administration actions Backbone performs, such as crating project versions. However, you can still restrict the permissions of the synchronization user to only have permissions for the projects you want to sync.

  1. Save the form

  2. Copy the Client Id and Client Secret

Step 3 - Cloud: Continue Setting Up The Sync

  1. In the partner instance column, enter the following data:

    • Base URL: the Base URL of the Data Center instance

    • Client Id / Client Secret: Enter this information from the application link you have created in step 2.7

  2. Choose to Authenticate or copy the link

    1. Authenticate: Leads you to the DC instance where you can authenticate to the sync user with the username and password

    2. Copy Link: Send over the link to the admin on the DC side so they can authenticate to the sync user with the username and password

  3. Select which project you want to synchronize

  4. For now, let's stick with the default name and description – just click Next

  5. On the overview screen, check the configuration details then click Create

Congratulations, you've established a synchronization! Now create the data center WebHook, so that the updates from the server instance can get synchronized.

Synchronize from Cloud to Cloud using The Remote License

Prerequisites

To set up a sync from Cloud to Cloud with the remote license you need the following:

Configure the Synchronization

  1. Go to the project that you want to synchronize on Cloud

  2. Select Project settings > Backbone Issue Sync > New Synchronization > Synchronize with a Cloud Instance

  3. In the Partner Instance column, enter the following data:

    1. In the Base URL field, enter the base URL of the Jira instance you want to synchronize with – it will have this structure: https://example.atlassian.net

    2. In the Project Key field, you can enter a specific project key of a project in the partner instance. Enter Cloud Project B's project key, and click Next

  4. Choose to Authenticate or copy the link

    1. Authenticate: Leads you to the Cloud instance where you can authenticate to the sync user with the username and password

    2. Copy Link: Send over the link to the admin on the Cloud side so they can authenticate to the sync user with the username and password

  5. On the overview screen, check the configuration details then click Create

Synchronize from Cloud to Data Center using The Remote License

The steps to set up the remote license from Cloud to Data Center are the same as using a marketplace license. Therefore, please refer to these steps.


JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.