Installing zAgileConnect for JIRA Server

Estimated time for installation and configuration: 30-45 minutes


Integration User

An Integration User account is used in each application to perform transactions in the other.  This also means that users do not need to have accounts in both applications to leverage this integration.

Before embarking on the installation steps, please be sure to have an account in each of the two applications that will be used for authentication and for submitting all transactions to the other application.  We recommend setting up an integration user account in each - Salesforce and JIRA for this purpose.  Furthremore, the profiles associated with each account will depend on the types of actions it will perform in the other application.  

Typically, Salesforce User and JIRA User/Developer profiles suffice for most of the integration functions.   

Admin privileges are not required for either of these accounts configured as Integration Accounts.  

HTTPS Access

Communication between Salesforce and On-Premise JIRA (aka JIRA Server) requires secure connectivity via HTTPS.  Please make sure your JIRA is accessible to Salesforce whitelisted IP addresses.  Specifically:


Installing the Salesforce Package

The zAgileConnect Salesforce package is available from Salesforce AppExchange.

To install the zAgileConnect Salesforce package, click on 'Get it Now'. This will initiate package installation into the organization for which you provide the credentials.  

We recommend that you install the package for "All Users" and use the License to manage access.

Installing JIRA Add-on

zAgileConnect add-on for JIRA is available directly from the Atlasssian Marketplace.  However, you may also download it here based upon your JIRA version.  

JIRA Add-on Compatibility Matrix and Download

 Please be sure to download the plugin version that corresponds to Salesforce package.

Using the JIRA UPM (Universal Plugin Manager), install the zAgileConnect Add-on for JIRA Server from Atlassian Marketplace

Enabling Access between JIRA and Salesforce

Authenticating Salesforce & JIRA

Sign in to JIRA

Enter the JIRA URL in the zAgileConnect package configuration, as shown below, and log in to JIRA using the JIRA integration account

Sign in to Salesforce

In JIRA Addon Admininstation section via Salesforce Authentication option, authenticate Salesforce to JIRA using the Salesforce integration user