> For the complete documentation index, see [llms.txt](https://docs.darksail.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.darksail.ai/echo-salesforce/setup/configuration.md). # 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 ** in the Authorize Endpoint URL input field, replacing *your-domain* with your Org's My Domain * [ ] Enter ** 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