OAuth 2.0 Setup - Create & Configure a Jira Connection

This step involves:

  1. Creating a connection

  2. Creating Named and External credentials to be used for callouts to Jira from Salesforce

  3. Enabling Named credential for callouts

  4. Linking the External Credential to the Auth. Provider created earlier

1. Creating a Connection

In zAgileConnect Setup add a new Jira and specify an Alias

Skip this step if there is already a connection to the Jira instance and/or you are migrating authentication from OAuth 1.0 → OAuth 2.0).

CleanShot 2025-06-04 at 16.50.43@2x-20250604-215054.png

2. Creating Named and External Credentials

In the zAgileConnect package configuration -> Jira Connection Settings → Step 1 (Sign in to Jira),

CleanShot 2025-06-04 at 17.03.17@2x-20250604-220329.png

Switch to Authentication via Named Credentials link

CleanShot 2025-06-04 at 17.04.26@2x-20250604-220437.png

Select the Jira Product (Jira Cloud / Jira Data Center), if requested fill the Jira Base URL

CleanShot 2025-06-04 at 17.06.18-20250604-220621.png

After confirming, new Named Credential and External Credentials will be created.

3. Enabling Named credential

To access the named credential configuration go to the “Configure” link for the Admin Named Credential

CleanShot 2025-06-04 at 17.23.07@2x-20250604-222319.png

Edit the Named Credential, enable “Enable for Callouts“ option and Save.

CleanShot 2025-06-04 at 17.44.06@2x-20250604-224421.png

4. Linking the External Credential to the Auth. Provider

From the Named Credential page, go to the External Credential configuration

CleanShot 2025-06-04 at 17.46.20@2x-20250604-224641.png

Edit the External Credential and set the Authentication Protocol to OAuth 2.0

CleanShot 2025-06-04 at 17.50.26@2x-20250604-225053.png

Set the Identity Provider to the Auth. Provider created earlier and Save

CleanShot 2025-06-04 at 17.53.03@2x-20250604-225321.png