/
Administration

Administration

Connection configuration overview

The connection configuration page allows you to configure connections between Confluence and Jira. Confluence-Jira connection can contain several space-project connections, called synchronised.

One Confluence instance can be connected to multiple Jira instances at the same time.

Configuration page with established connections and synchronisers

Confluence - Jira Connection

The Confluence - Jira connection is the first level of link established on the connection configuration page. To create this connection, follow the steps outlined below. Once you have created a Confluence - Jira connection, you can proceed to create a Space - Project configuration.

Initial configuration page with synchronised

Connection can be created only by a user with admin permission for both Jira & Confluence. This user can later be changed if needed.

To get started with the app and configure the first connection between Jira and Confluence, follow these steps:

  1. Go to the SWFC configuration tab in Confluence settings.

  2. Select "Create Jira connection".

  3. A new page will open with an authorization request. Select your Jira instance URL and click "Accept".

  4. After this, you will be redirected back to the app’s configuration page with an automatically opened dialogue:

image-20240921-161733.png
  1. Select a Jira instance one again, the same as on the previous page.

  2. Note that your user has been selected as the Authorized connection account.

Authorized connection account plays the role of a technical user that is used as a default (or sometimes fall-back) source of permissions for actions performed in Jira when Confluence users do not have any.

  1. Mark a checkbox to enable Jira user authorization.

After completing these steps, your Confluence instance will be connected to Jira through the STAGIL app and the created connection will be displayed one app’s configuration page.

Space - Project Synchronizer

The Space-Project synchronizer is the second link level established on the app configuration page. This configuration allows you to specify projects - space association within a particular Confluence - Jira connection.

Learn how to create a Space - Project syncronizer here: Space - Project Synchronizer.

To create a Space-Project synchronizer, a Confluence-Jira connection must be already created.

 

Authorized Connection Account (technical user)

An administrator who configures the synchronizer will be recognised as a Technical User.

This user must have the following permissions in every project in a syncronizer.

  • browse project

  • create issues

  • transition issues

image-20240603-150006.png

Technical user can be changed at any time after the connection is created. To change the technical user, the new user needs to access the Actions menu via the [···] button and select Authorize Jira site. This will re-write the existing authorization based on the new (current) user’s permissions.

image-20240805-225636.png

User permissions

If a Confluence user also has a Jira account, their permission to change the page status or edit Issue Fields will be based on their Jira permissions.

If a Confluence user does not have a Jira account, the app will use the technical user’s permissions instead to update the synced issue.

Also see:

Editing an existing synchroniser

Jira user authorization

 

© 2023, STAGIL