-
In the left sidebar, click on the ellipsis next to Apps and select “Manage apps”
-
In the left sidebar, click on the “Plum CRM” app and then select “Connection”
-
You will see a page with no connections
-
Click on the new Connection button on the top right
-
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 |
|
|
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 |
-
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.
Next Step: Using the Plum CRM app