Plum CRM for Jira Cloud Documentation

Connection

  1. In the left sidebar, click on the ellipsis next to Apps and select “Manage apps”

  2. In the left sidebar, click on the “Plum CRM” app and then select “Connection”

  3. You will see a page with no connections

    connections-2.png


  4. Click on the new Connection button on the top right

    connections-3.png
  5. In New or Existing Connections, you will see two authentication types:

  • Integration User (User-Based): Select the required user from the drop-down list.

  • Service Account (OAuth 2.0): Follow the steps below to configure and use a Jira Cloud service account with OAuth 2.0 authentication for PLUM CRM integrations.

The OAuth 2.0 service account setup involves configuring the required scopes and generating the client credentials.

Step 1 – Create OAuth 2.0 Credentials

a. Sign in to Atlassian Administration using an authorized administrator account.

b. Navigate to the service account management area.

c. Select the required service account.

d. Open the option to create OAuth 2.0 credentials.

e. Select the required scopes for the service account.

Read

  • read:jira-user

  • read:jira-work

Manage

  • manage:jira-configuration

  • manage:jira-project

Write

  • write:jira-work

f. Create the credentials for the intended integration.

g. Securely record the generated Client ID.

h. Securely record the generated Client Secret.

i. Add the service account user to jira-admins-<site-name> group

Step 2 – Configure a New or Existing Connection

a. Navigate to New Connection or select Edit for an existing connection.

b. Under Authentication Type, select OAuth 2.0.

c. Select the same service account that was used in Step 1.

d. Enter the Client ID and Client Secret generated in Step 1 (steps g and h).

e. Click Save & Test Connection to save the configuration and verify the connection.


Option Name

Description

Notes

Connection Name

Connection Name

Provide a unique name for your Connection

Jira Integration User (user-based Authentication)

Pick a User from the drop-down

This account MUST be reserved for data sync (user-based Authentication)

Jira/Sync Service Account (OAuth Authentication)

Pick a service account User from the drop-down

This account MUST be created with OAuth 2.0 credentials (OAuth Authentication)

Jira - Jira Space To Sync

Which space should sync to CRM? Leave this empty to sync all projects.


CRM System

Pick desired CRM System from the drop-down

Salesforce or Microsoft Dynamics

Endpoint URL

Pick CRM System URL from the drop-down

https://login.salesforce.com or https://test.salesforce.com

Salesforce Integration User

Username of Salesforce service account to sync data

This account MUST be reserved for data sync

Jira Spaces

Default Jira Project

When creating a new Jira issue from CRM, if you don't specify a project, this value is used.

CRM Space

Which space will contains new Jira records

When creating a new JIRA issue from CRM, a space should be selected. For multiple connections to be enabled this is a required field and must be unique to each connection.

Client Key


Created in the first install step described in How to set up Salesforce oauth



newConnection-2.png
  1. After you test and save the connection, click the copy button for the Plum CRM API key. Return to Salesforce, click on the “More” menu, and select “Plum CRM Authentication Settings.” Click “Edit” and enter the API key in the left-side field (for security purposes, the key will be hidden). Save.

    copyKey.png


    endPoint-1.png


    endPoint-3.png


Next Step: Using the Plum CRM app