
Prerequisites
- Salesforce Admin role
Use a service account (and not an employee account) with the suggested privileges for the integration to ensure continuity.
Create the Oleria App in Salesforce
1
Open the integration
Log in to your Oleria workspace, select Integrations → select Salesforce.
2
Review prerequisites and continue
A side page opens with prerequisites and a link to the onboarding instructions. Select Continue.

3
Provide your Salesforce URL
Provide your Salesforce URL and select Authenticate.

Turn the Sandbox switch on if you are integrating a Salesforce sandbox environment.
4
Authorize Oleria access
Authorize Oleria access to create a connected app called Oleria in your Salesforce application.


You will see an error notification: “User hasn’t approved this consumer”. Ignore this message and continue with the next sections to install the Oleria app and Oleria Access permission set in your Salesforce application.

Install the Oleria App in Salesforce
1
Find and install the Oleria app
Log in to your Salesforce application, search for Connected Apps OAuth Usage, select the Oleria app, and select Install.

2
Edit policies
After completing the Oleria app installation, select Edit Policies.

3
Configure OAuth policies
Navigate to the OAuth Policies section, set Permitted Users to Admin approved users are pre-authorized, and select Save.

Create a Permission Set for Oleria Access
1
Create the permission set
Navigate to Permission Sets and select New to create a new permission set named Oleria Access.

2
Configure the permission set
Set the Label to Oleria Access and configure the API Name as shown below, then save the permission set.

3
Assign a user
Open the Oleria Access permission set and select Manage Assignments to assign a user.
Select Add Assignment and assign the user.


4
Assign the Oleria connected app
Open the Oleria Access permission set and select Assigned Connected Apps to add the Oleria app to the permission set.
Select Edit in the Assigned Connected Apps section, select Oleria, and select Save.


5
Configure system permissions
Select System Permissions.
Select Edit and select View All Data, View Health Check, and Manage Multi-Factor Authentication in API.

To perform remediations, also select the following permissions:
Select Edit and select Order Name as shown below.



-
To disable accounts - enable Manage Users

-
To remove users from groups - enable Modify All Data



Skip the Orders step if the Orders object does not exist.
Configure Event Monitoring
Oleria recommends enabling and configuring Event Monitoring (Shield) in your Salesforce instance. This captures all user activity and provides insights into it. Without Event Monitoring (Shield), user activity insights are limited to login and logout activities.1
Enable Event Manager storage and streaming
Select Set up → search Event Manager → enable Storage and Streaming for all events.

Connect Salesforce to Oleria
1
Open the integration
Go to your Oleria workspace, select Integrations → select Salesforce.

2
Authenticate
Provide your Salesforce URL and select Authenticate.

3
Confirm the connection
You can find the newly integrated Salesforce instance in your Oleria workspace connected integrations.


