Configuration

Connect Your Org to the DarkSail API

Create a Service Worker

• Navigate to the Salesforce Setup Menu by clicking the gear icon at the top of any Salesforce page and selecting "Setup"

• Navigate to the Users setup page by entering the query Users in the Quick Find search box in the navigation bar on the left side of the page

• Create a new User by clicking the "New User" button

• Assign the service worker User the "Salesforce Integration" User License and the "Minimum Access - API Only Integrations" Profile. Configure the other User settings as you see fit

• Save the new User by clicking the "Save" button

• On the Users setup page, view the service worker User you created by clicking the User's username

• Click the "Edit Assignments" button in the Permission Set Assignments section

• Under Available Permission Sets, find the "EchoServiceWorker" Permission Set, click it, and enable it for the User by clicking the "Add" button

Configure the Echo Connected App

• Navigate to the Salesforce Setup Menu

• Navigate to the Manage Connected Apps setup page

• Click the "Edit" button next to the EchoCA Connected App listed in the table

• Under Custom Connected App Handler, enter the name of the service worker User in the Run As input field

Configure the Echo Auth. Provider

• Navigate to the Salesforce Setup Menu

• Navigate to the Manage Connected Apps setup page

• Click the "View" button next to the EchoCA Connected App listed in the table

• Under API, click the "Manage Consumer Details" button

• Generate a new set of Consumer credentials by clicking the "Generate" button, and then save those credentials to the Connected App by clicking the "Apply" button

• In a new window, navigate to the Salesforce Setup Menu

• Navigate to the Auth. Providers setup page

• Click the "Edit" button next to the EchoAuthProv Auth. Provider listed in the table

• Copy the Consumer Key and Consumer Secret values from the Consumer Details page, and paste them into the corresponding fields on the Auth. Provider Edit page

• Enter https://your-domain.my.salesforce.com/services/oauth2/authorize in the Authorize Endpoint URL input field, replacing your-domain with your Org's My Domain

• Enter https://your-domain.my.salesforce.com/services/oauth2/token in the Token Endpoint URL input field, again replacing your-domain with your Org's My Domain

• Save the Auth. Provider configuration by clicking the "Save" button

Configure the Echo Named Credentials

• Navigate to the Salesforce Setup Menu

• Navigate to the Named Credentials setup page

• Click the "Edit" button next to the EchoNCred Named Credential listed in the table

• Replace your-domain with your Org's My Domain in the URL input field

• Save the Named Credential configuration by clicking the "Save" button

• On the Named Credentials setup page, click the "Edit" button next to the EchoExtCred Named Credential listed in the table

• Replace your-domain with your Org's My Domain in the URL input field

• Save the Named Credential configuration by clicking the "Save" button

Add the Lightning Background Utility Component to Your Org's Lightning Apps

• Navigate to the Salesforce Setup Menu

• Navigate to the App Manager setup page

Complete the following steps for each Lightning App you'd like to fingerprint all traffic to:

• Click the dropdown button and then the "Edit" button next to the Lightning App listed in the table

• Navigate to the Utility Items App Settings page by clicking the "Utility Items (Desktop Only)" button in the navigation bar on the left side of the page

• Click the "Add Utility Item" button above the Utility Item table

• Under the Custom - Managed section, click the "DarkSailFingerprinter" Utility Item to add it to your Lightning App

• Save the Lightning App configuration by clicking the "Save" button