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.

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.

Please note: By accepting the request you agree that the other party can see your project's set up with all fields (and users). This is because Backbone (based on the Atlassian-addons-project-access permissions) needs to have the following permissions per functionality in order to synchronize properly:

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 > Request synchronization 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. For now, let's stick with the default name and description – just click Next
4. Check the configuration settings, and 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

Please note: By accepting the request you agree that the other party can see your project's set up with all fields (and users). This is because Backbone (based on the Atlassian-addons-project-access permissions) needs to have the following permissions per functionality in order to synchronize properly:

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