« Table of Contents

Using the Auto-Connect Integration Wizard

The Auto-Connect integration panel contains special integration for specific git hosts, supports multiple connected repositories and automates git integration.

We highly recommend this feature for multiple repository configuration.

For more details on this topic, see the connection information for your favorite git host in our Integration Guides.

Using the Connect Wizard

  1. Click Connect to Git Repository.  The Add Git Repository wizard is displayed.
  2. Enter required repository location. The Repository location can be any type of supported URL protocols as stated in the Location type examples.
  3. Click Next. The wizard will automatically detect the entered repository location type.

Detection of Remote Origin Setting
The detection works for most repositories. If a repository root points to a valid git repository, the repository origin is detected automatically.  When a repository has no origin, the user has to specify it manually.
Do note that the repository wizard clones the remote repository by default.  It does not clone local repositories. For local repositories, the root is set to local path and fetches are disabled.
Starting v2.6.7 of the Git Integration app, the default identities are not used and the repository is created without the additional key upload.
If the Git repository file system is somehow available to the Jira server, you can save the clone step and save the disk space on a Jira server by pointing the Jira server straight at it.


In the Settings screen, you can configure features such as Smart Commits, Repository Browser and Project Permission settings.

Enable or disable the Smart Commits setting for this repository as required.

For Project Permissions, set one or more projects in the Restrict to projects field to map this repository and make the Git Commits tab available in the Issue pages of the associated projects. Otherwise, leave the Associate with all projects setting to ON to associate this repository to all projects.

The level of permissions can be one of the following:

Level Process
Repository Select a repository from the repository list. For integrations, view the integration then select a repository within (Actions > Show integration repositories). After the selection, you will be taken to the repository properties.
Set the Project Permissions as follows:
  1. Uncheck the Associate with all projects option.
  2. Click the Restrict to project field and select a project.
  3. Save/Update the repository settings.
Integration Select an integration from the repository list then open the integration properties (Actions > Edit integration feature settings). Set the Project Permissions as follows:
  1. Uncheck the Associate with all projects option.
  2. Click the Restrict to project field and select a project.
  3. Save/Update the repository settings.
All This is the default setting where the Associate to all projects option is enabled.
For Project Permissions, the View Development Tools project permission must be granted to Users > Group > Project Roles.

Click Next.

HTTP(S) Authentication

If the entered git clone URL requires http credentials, the following screen appears:

Provide Username and Password in the respective fields then click Next to continue.

The HTTP authorization errors indicate that the credentials provided are not valid.

SSH Authentication

For SSH git repository connections, the following screen is displayed for authentication:

Upload the private key file via Browse... and navigate to the private key file or pasting the private key text into the provided box.

For establishing safety connection with SSH, upload a Public Key to the SSH server and set the Private Key to the SSH client.
Take note that the SSH server is the Git server and the SSH client is the Jira server.
When adding a new repository that requires an SSH key, you can now pick an existing associated key in the Existing key list.

Click Next to proceed.

Passphrase Input

If the generated SSH key pair has a passphrase, you will see the following screen:

Enter the Passphrase for your private key. Click Next to continue.

The passphrase screen only appears if the user has added an SSH key that requires a passphrase.
The Git Integration for Jira app will initially try to use the keys provided by the user before using the keys from the home directory.

After the above requirements are fulfilled, the wizard will:

  • create a local copy of the git repository; and
  • index the git repository to build change history.

Click Finish to close the wizard.  The newly added repository appears on the integration list on the app repository configuration page.


« Table of Contents