Estimated time for installation and configuration: 30-45 minutes
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.
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:
- Your corp. JIRA is accessible to Salesforce whitelisted IP addresses via HTTPS. - https://help.salesforce.com/apex/HTViewSolution?id=000003652&language=en_US&elq_mid=4198&elq_cid=
- Your SSL certificate for JIRA is from a Salesforce-approved CA - https://developer.salesforce.com/page/Outbound_Messaging_SSL_CA_Certificates
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.
|JIRA Version||Add-on for SF Package v1.8.x||Add-on for SF Package v1.7.x||Add-on for SF Package v1.6.x|
|6.1 -> 6.3||ZSalesforceJIRA-1.8.0-1.jar||ZSalesforceJIRA-1.7.12-1.jar||ZSalesforceJIRA-18.104.22.168.jar|
|7.0.x - 7.2.x||ZSalesforceJIRA-1.8.0-3.jar||ZSalesforceJIRA-1.7.11-3.jar||ZSalesforceJIRA-1.6.6-3.jar|
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