Salesforce

Salesforce is a customer relationship management solution that brings companies and customers together.
Salesforce connector pulls the event monitoring data that contains information useful for assessing organisation usage trends and user behavior.

Prerequisites

  • Connectivity with salesforce API using valid credentials

  • Required credentials:

    • Username
    • Password
    • Consumer key
    • Consumer secret
    • Security token
    • Instance URL

Steps to setting up salesforce account

CREATE A CONNECTED APP

Follow below steps to create a connected app

  • Login to Salesforce Administrator account.

image 1-Nov-16-2023-09-04-49-7960-AM

  • Click on the setup icon on the navigation bar.
  • Navigate to the Platform Tools tab on the left panel.
  • Navigate to Apps > App Manager.

image 2-3

  • Click New Connected App.
  • Fill out the necessary fields, select Enable OAUTH settings checkbox
  • Enter value for callback url
  • Select Manage user data via APIs (api) and Perform requests at any time (refresh_token, offline_access) in Selected OAuth Scopes column
  • Uncheck Require Secret for Refresh Token Flow checkbox

image 3-3

  • Click Save.
  • Navigate to Platform Tools > Apps > App Manager.
  • Navigate to your created connected app and click on the arrow on the right side.

image 4-1

  • Select view option from the menu.
  • Navigate to API (Enable OAuth Settings) section, click on Manage Consumer Details button.

image 5-2

  • Copy the values of the consumer key and consumer secret and keep it.

image 6-1

CREATE USER PROFILES

User profiles defines user's access to objects and data, and tasks allowed to the user within the application.

Follow below steps to create user profile in salesforce:

  • Login to salesforce administrator account.
  • Click on the setup icon on the navigation bar.

image 7-1

  • Navigate to ADMINISTRATION tab on left panel
  • Navigate to Users > Profiles section
  • Click on the new profile button

image 8-1

  • Select existing profile as standard user
  • Specify a name for the profile

image 9

  • Click Save
  • Now click on the edit button.
  • Navigate to Connected App Access, select the connected apps you want to access using this profile.

image 10

  • Navigate to Administrative Permissions, select API Enabled and Manage Users checkbox.

image 11

  • Navigate to General User Permissions, select View Event Log Files checkbox.

image 12

  • Click Save.

CREATE A USER IN SALESFORCE

Follow below steps to create user in salesforce:

  • Login to salesforce administrator account.
  • Click on the setup icon on the navigation bar.
  • Navigate to the ADMINISTRATION tab on the left panel.
  • Navigate to Users > Users.
  • Click on the New User

image 13

  • Fill out the necessary fields, select user license as Salesforce and select the profile we created in the previous step

image 14

  • To obtain a user password, select the “Generate new password and notify the user immediately” checkbox.
  • Click on save.

GET SECURITY TOKEN

Follow the steps to get a security token.

  • Login to Salesforce using the Salesforce account to be used by the connector.
  • Click the view profile section located in the upper right corner, then click Settings.

image 15

  • In the right panel of the page, navigate to My Personal Information > Reset My Security Token.

image 16

  • Click Reset Security Token.

image 17

  • Token will be sent to you via email.

Configurations

The following are the configurations to forward Salesforce logs to DNIF.‌

image 18

Field Name  Description
Connector Name Enter a connector name
Connector Type Enter salesforce_connector
Instance URL Enter salesforce instance URL
Salesforce User Enter salesforce username
Salesforce User Password Enter salesforce user password
Consumer key Enter salesforce Consumer key
Consumer secret Enter salesforce Consumer secret
Security Token Enter salesforce Security Token
  • Click Save after entering all the required details and click Test Connection, to test the configuration.
  • Connection successful message will be displayed on screen along with the time stamp.
  • If the connection is not successful an error message will be displayed. Refer Troubleshooting Connector Validations for more details on the error message.

Once the connector is configured, validate if the connector is listed under Collection Status screen with status as Active. This signifies the connector is configured successfully and data is ready to ingest.