Focus

SaaS Security

Onboard a Salesforce App to SSPM

Table of Contents

Onboard a RingCentral App to SSPM

Onboard an SAP Ariba App to SSPM

Onboard a Salesforce App to SSPM

Connect a Salesforce instance to SSPM to detect posture risks.

Where Can I Use This?	What Do I Need?
Strata Cloud Manager	SaaS Security Posture Management license Or any of the following licenses that include the Data Security license: CASB-X CASB-PA

Where Can I Use This?

What Do I Need?

Strata Cloud Manager

SaaS Security Posture Management license

Or any of the following licenses that include the Data Security license:

CASB-X
CASB-PA

For SSPM to detect posture risks in your Salesforce instance, you must onboard your Salesforce instance to SSPM. Through the onboarding process, SSPM connects to a Salesforce API and, through the API, scans your Salesforce instance for misconfigured settings and account risks.

You can onboard your Salesforce instance through an interactive OAuth 2.0 authorization flow or through a Salesforce External Client App.

The interactive OAuth 2.0 Authorization flow relies on a Salesforce user account to authorize access through a browser-based login. You first create a permission set in Salesforce with the required access levels and assign this permission set to the designated Salesforce user. During onboarding, SSPM redirects you to Salesforce to log in as that user and manually approve the access that SSPM requires for its scans. This approach can be faster to set up, because it uses existing Salesforce credentials. It also leverages any single sign-on (SSO) or multi-factor authentication (MFA) requirements already established by your organization.

The External Client App approach authenticates by using application credentials (Client ID and Client Secret). Instead of a manual login redirect, you create an External Client App within Salesforce and configure its settings to define security policies and a "Run As" user. During onbaording, you provide SSPM with the application credentials, which SSPM uses to authenticate to Salesforce. This method offers long-term stability by creating a persistent, system-to-system link. Unlike the interactive OAuth 2.0 authorization flow, this method does not rely on the continuous validity of OAuth refresh tokens, which can expire or be revoked.

Onboard a Salesforce App to SSPM Using OAuth 2.0

Connect a Salesforce instance to SSPM to detect posture risks.

SSPM can get access to your Salesforce instance through OAuth 2.0 authorization. During the onboarding process, you are prompted to log in to Salesforce and to grant SSPM the access it requires.

To access your Salesforce instance, SSPM requires the following information, which you will specify during the onboarding process.

Item	Description
Instance URL	The unique web address for your Salesforce instance. SSPM uses this address to locate and communicate with your specific environment. The instance URL has the format https://.my.salesforce.com.

To onboard your Salesforce instance, you complete the following actions:

Make note of your organization's Salesforce instance (domain) URL.

Your instance URL, which is typically used as your login URL, has the format https://<instance_name>.my.salesforce.com. You will provide this entire URL, including the https:// prefix, to SSPM during the onboarding process.

If necessary, you can locate your instance URL from the My Domain Settings page.
1. Click the settings icon (gear icon) in the upper-right corner of the page, and select Setup.
2. From the Setup page's left navigation pane, select Company SettingsMy Domain. These items appear under the SETTINGS section of the menu.
3. On the My Domain Settings page, the Current My Domain URL field contains your instance URL. Remember to add the https:// prefix when you provide this URL to SSPM.

Identify the Salesforce account that you will use to log in to Salesforce during onboarding.

SSPM will use this account to establish a connection to your Salesforce instance. After SSPM establishes the connection, it will perform an initial scan of your Salesforce instance, and will then run scans at regular intervals. Depending on the access scopes that the account can grant to SSPM, SSPM can run configuration scans of your Salesforce settings, risky account scans, identity scans, and scans of third-party plugins that are connected to your Salesforce instance. For SSPM to run these scans, the Salesforce account that you use to establish the initial connection must remain available. For this reason, we recommend that you use a dedicated service account to grant SSPM access. If you delete the service account, or change the account's password, the scans will fail and you will need to onboard Salesforce again.

The account that you use to connect to your Salesforce instance can have the full permissions that SSPM requires to complete all its scans and perform automated remediation. You can also use an account that has reduced permissions, in which case some SSPM function will not be available. For example, you might want to use an account with reduced permissions if your organization places limits on service-account permissions. During onboarding, SSPM gives you an option to connect with read-only permissions or with read and write permissions. The onboarding screen also lists the API scopes that SSPM requires for each scan type. After establishing a connection, SSPM will notify you if it is unable to run certain scans because the account did not have the required permissions to grant access to certain scopes.

Permissions for Read Access: To grant SSPM reduced permissions to perform configuration scans, identity scans, and risky account scans, the account that you use to connect SSPM to your Salesforce instance requires the following permissions. With only these reduced permissions, SSPM will not be able to perform third-party plugin scans or automated remediation.

Scan Type	Required Permission
Configuration	API Enabled View Health Check
Risky Accounts	API Enabled In addition to API Enabled permission, you must also disable login with Salesforce credentials for the account. You can do this by selecting the Disable login with Salesforce credentials checkbox on the Single Sign-on Settings page. More information on this setting is available in the following step.
Identity	API Enabled View Event Log Files View Setup and Configuration View All Users

The Identity permissions described in the preceding table typically give SSPM access to the Salesforce objects and fields that SSPM needs to complete its identity scans. During onboarding, SSPM will verify that it can access these objects and fields. If it cannot access these fields, onboarding will fail with the following message.

Your Salesforce org may be missing required fields or permissions for our Identity security moitoring queries.

If onboarding fails with this message, verify that the account can access the required objects and fields. See Required Objects and Fields for Identity Scans for more information.

Additional Permissions for Write Access: To grant SSPM full read and write access, the account that you use to connect SSPM to your Salesforce instance requires the permissions for read access described above, and also the following additional permissions. These additional permissions are required for third-party plugin scans, and for automated remediation of misconfigured settings.

Scan Type / Remediation	Required Permission
Configuration Remediation	API Enabled View Health Check Download AppExchange Packages
Third-Party Plugins	API Enabled Download AppExchange Packages

To grant the permissions to the user account, you can add the permissions to a permission set, and then assign the permission set to a Salesforce user account.

Add the required permissions to a permission set.
1. From the setup home page in Salesforce, select UsersPermission Sets.
2. You can create a new permission set or edit an existing permission set to add the permissions.
  To create a permission set, click New, fill in the basic information, and Save.
  To edit an existing permission set, click its name in the Permission Set Label column.
3. On the setup page for the permission set, locate the System area and navigate to System Permissions.
4. On the System Permissions page for the permission set, Edit the permissions.
5. In the list of system permissions, select the Enabled check box for each of the required permissions.
  
  When you enable a permission that requires other permissions, Salesforce will automatically enable the other required permissions.
6. Save your changes.
Assign the permission set to a Salesforce user account.
1. From the setup home page in Salesforce, select UsersUsers.
2. From the list of users, click the name of the user.
3. On the setup page for the user, locate the Permission Set Assignments area to Edit Assignments.
4. On the Permission Set Assignments page, locate the permission set in the Available Permission Sets list, Add it to the Enabled Permission Sets list for the user, and Save your changes.

Verify that your account configuration supports SSPM risky account scans.

SSPM supports risky account detection for Salesforce. For the risky account scan to work correctly, SSPM requires that you enable a particular setting on the Single Sign-on Settings page. This step is required only for the risky account scan; the configuration scans and third-party plugin scans will be unaffected.
1. From the setup home page in Salesforce, navigate to the Single Sign-on Settings page. To navigate to this page, select IdentitySingle Sign-on Settings.
2. On the Single Sign-on Settings page, locate the Delegated Authentication area, and make sure that the Disable login with Salesforce credentials checkbox is selected.
  
  If the Disable login with Salesforce credentials checkbox is not already selected, make sure that you understand the implications of selecting this checkbox. Modifying any setting on your Salesforce Single Sign-on Settings page might affect your users.
Log out of all Salesforce accounts.

Logging out of all Salesforce accounts helps ensure that you log in under the correct account during the onboarding process. Some browsers can automatically log you in by using saved credentials. To ensure that the browser does not automatically log you in to the wrong account, you can turn off any automatic log-in option or clear your saved credentials. Alternatively, you can prevent the browser from using saved credentials by opening the Cloud Management Console in an incognito window.
Connect SSPM to your Salesforce instance

By adding a Salesforce app in SSPM, you enable SSPM to connect to your Salesforce instance. You must consent to specific permissions when adding the Salesforce app.

In September 2025, Salesforce updated its security policy for connected OAuth apps. This update impacted our Salesforce connector, causing onboarding and re-authencation to fail. To onboard or re-authenticate to Salesforce, you might need to complete additional configuration steps to meet new Salesforce requirements. Before onboarding, review the information in Install the SSPM OAuth App in Salesforce.
1. Log in to Strata Cloud Manager.
2. Select ConfigurationSaaS SecurityPosture SecurityApplicationsAdd Application and click the Salesforce tile.
3. On the Posture Security tab, Add New instance.
4. Select the option for OAuth 2.0.
5. Enter your Instance URL.
6. Specify whether you want SSPM to connect with Read Permissions only or with Read and Write Permissions.
  
  The onboarding page lists the API scopes that SSPM will access to complete its various scans and to perform remediation.
7. Connect with Salesforce.
  
  SSPM redirects you to the Salesforce login page.
8. Log in to the Salesforce account.
  
  Salesforce displays a consent form that details the access permissions that SSPM requires.
9. Review the consent form and allow the requested permissions.
  
  SSPM connects to your Salesforce instance, and displays whether it was able to access the API scopes that it requires for its scans. If SSPM is unable to access necessary scopes, it indicates which scan types it will not be able to perform.

Install the SSPM OAuth App in Salesforce

In September 2025, Salesforce updated its security policy for connected OAuth apps. This update impacted our Salesforce connector, causing onboarding and re-authencation to fail. To onboard or re-authenticate to Salesforce, you need to complete these additional configuration steps to install the SSPM OAuth app in Salesforce. You will need to complete these steps for your Salesforce instance only once.

Salesforce now restricts the use of uninstalled connected OAuth apps. These are apps that a user has authorized during the OAuth flow, and which weren’t formally installed by a Salesforce administrator. Salesforce now requires the connected OAuth apps to be installed. Our connector uses the OAuth 2.0 flow, which creates an uninstalled OAuth app in Salesforce. Because this approach violates Salesforce's new requirements, onboarding and re-authentication are failing. To fix this problem, you will navigate to the Connected Apps OAuth Usage page in Salesforce, locate SSPM's uninstalled OAuth app, and install the app.

If you have never onboarded Salesforce to SSPM, Salesforce will never have created an uninstalled connected OAuth app for SSPM. In that case, you must first connect your Salesforce instance to SSPM to have Salesforce create an uninstalled connected app.

If you previously connected SSPM to your Salesforce instance (prior to the new restriction introduced in September 2025), you don’t need to complete this step. Salesforce will have already created the uninstalled connected OAuth app.

As a Salesforce System Administrator, or as a user with Salesforce's new Approve Uninstalled Connected Apps user permission, complete the onboarding steps.

Required Permissions: The account you use to onboard must have the Approve Uninstalled Connected Apps permission, which Salesforce automatically includes in the System Administrator user profile.
Install the uninstalled connected OAuth app.
1. Log in to Salesforce as a System Administrator.
2. From the setup home page in Salesforce, select AppsConnected Apps Connected Apps OAuth Usage. These items appear under the PLATFORM TOOLS section of the menu.
3. On the Connected Apps OAuth Usage page, locate the entry for SSPM's connected OAuth app.
  
  The name of SSPM's connected OAuth app differs by region, but begins with SSPM.
4. From the Activities column of the table, Install SSPM's connected OAuth app.
If you had never onboarded Salesforce to SSPM, and completed step 1 of these instructions, you will now want to reduce the permissions of the account you used for onboarding.
If you had previously connected SSPM to your Salesforce instance, you needed only to complete step 2. You don’t need to complete this step.

In Step 1 of these instructions, you onboarded Salesforce to SSPM by using a System Administrator account or another account with Approve Uninstalled Connected Apps permission. SSPM no longer needs these extra permissions. These added permissions were required only for the initial onboarding for Salesforce to create the connected OAuth app. Now that the initial onboarding is complete, reduce to account's permissions to only the permissions the SSPM requires. These permissions are listed earlier in this topic.
- If you granted the Approve Uninstalled Connected Apps permission to a user account, remove that permission.
- If you used a System Administrator account to onboard, change the account profile to a profile other than the System Administrator profile. If you need to keep that account as a System Administrator account, remove the Salesforce app from SSPM and re-onboard using an account with reduced permissions.

Required Objects and Fields for Identity Scans

To complete identity scans, SSPM requires access to certain Salesforce objects and their fields. During onboarding, SSPM will verify that it can access these objects and fields. If it cannot access these fields, onboarding will fail with the following message.

Your Salesforce org may be missing required fields or permissions 
for our Identity security monitoring queries.

If you get this message, check the following possible causes:

Verify that you account has the permissions that SSPM requires to run identity scans. The following permissions are required:
- API Enabled
- View Event Log Files
- View Setup and Configuration
- View All Users
Verify that the account can access the following objects and fields. Confirm that your user profile and permission sets are not blocking access to the required Salesforce objects and fields

Salesforce Object	Required Fields
EventLogFile	Id, EventType, LogFile, Interval, LogDate
ConnectedApplication	Id, Name, CreatedDate, CreatedById, LastModifiedDate, LastModifiedById
SetupAuditTrail	Id, Action, Section, CreatedDate, CreatedById, Display, CreatedByIssuer
User	Id, Name, Email, LastLoginDate, CreatedDate, LastPasswordChangeDate
PermissionSetAssignment	PermissionSet. PermissionsModifyAllData, AssigneeId

Onboard a Salesforce App to SSPM Using an External Client App

Connect a Salesforce instance to SSPM to detect posture risks.

For SSPM to detect posture risks in your Salesforce instance, you must onboard your Salesforce instance to SSPM. During onboarding, SSPM connects to the Salesforce API through an External Client App that you create. By leveraging the OAuth 2.0 protocol, the External Client App provides the secure framework for SSPM to access your Salesforce configuration. Once authenticated, SSPM uses the API to scan your Salesforce environment for misconfigured settings and account risks.

The supported Salesforce editions for SSPM scans are the following editions:

Enterprise Edition
Unlimited Edition
Developer Edition
Professional Edition with the API Add-on

To access your Salesforce instance, SSPM requires the following information, which you will specify during the onboarding process.

Item	Description
Instance URL	The unique web address for your Salesforce instance. SSPM uses this address to locate and communicate with your specific environment. The instance URL has the format https://`<instance_name>`.my.salesforce.com.
Client ID	SSPM will access a Salesforce API through a Salesforce External Client App that you create. Salesforce generates the Client ID to uniquely identify the External Client App. The Client ID acts as a username for SSPM to identify itself during the connection process. The Salesforce interface calls this ID the Consumer Key.
Client Secret	SSPM will access a Salesforce API through a Salesforce External Client App that you create. Salesforce generates the Client Secret, which acts as a password that SSPM uses to securely authenticate and establish the OAuth connection. The Salesforce interface calls this secret the Consumer Secret.

Setting up a Salesforce External Client App involves two distinct requirements: a user with permission to create and configure the app, and a Run As user account. The Run As user is the account whose identity the app assumes to interact with Salesforce data. The Run As user provides the security context for the External Client App, ensuring it can access only the records and fields permitted by that account’s permissions.

Although accounts assigned to the System Administrator Profile have the necessary permissions to create the External Client App and to act as the Run As user, you might prefer to use accounts that have only the minimum necessary permissions.

To create and configure the External Client App, the user account requires only the Create, edit, and delete External Client Apps permission. To adhere to the principle of least privilege, you can create a specialized permission set with this permission and assign it to the user who will create the External Client App.

To act as the Run As user, the user account requires the following minimum permissions:

API Enabled
View Health Check
Customize Application
Manage Sharing
Manage Users
Download AppExchange Packages

During onboarding, you will specify whether you want SSPM to connect with Read Permissions only or with Read and Write permissions. The Run As user requires the Download AppExchange Packages permission only if you plan to grant SSPM full Read and Write permissions during onboarding.
View Event Log Files
View Setup and Configuration
View Roles and Role Hierarchy
Assign Permission Sets
Modify Metadata Through Metadata API Functions

To adhere to the principle of least privilege, you can create a specialized permission set with only these permissions and assign it to the user who will act as the Run As user. To support specific SSPM features, the Run As user account requires only the following permissions:

Feature	Permission	Type
Configuration Scans	API Enabled View Health Check	Read Permission
Risky Account Scans	API Enabled In addition to the API Enabled permission, you must also disable login with Salesforce credentials for the account. You can do this by selecting the Disable login with Salesforce credentials checkbox on the Single Sign-on Settings page. More information on this setting is available in the following steps.	Read Permission
Identity Scans	API Enabled View Event Log Files Customize Application Manage Users	Read and Write Permission
Third-Party Plugin scans	API Enabled Download AppExchange Packages	Read and Write Permission
Remediation	API Enabled View Health Check Download AppExchange Packages	Read and Write Permission

To onboard your Salesforce instance, you complete the following actions:

The following steps assume that you are using the Salesforce Lightning Experience UI, which is now the default UI for most Salesforce accounts. If you are using the Salesforce Classic UI, you can click the Switch to Lightening Experience in your page header to follow these instructions.

Make note of your organization's Salesforce instance (domain) URL.

Your instance URL, which is typically used as your login URL, has the format https://<instance_name>.my.salesforce.com. You will provide this entire URL, including the https:// prefix, to SSPM during the onboarding process.

If necessary, you can locate your instance URL from the My Domain Settings page.
1. Click the settings icon (gear icon) in the upper-right corner of the page, and select Setup.
2. From the Setup page's left navigation pane, select Company SettingsMy Domain. These items appear under the SETTINGS section of the menu.
3. On the My Domain Settings page, the Current My Domain URL field contains your instance URL. Remember to add the https:// prefix when you provide this URL to SSPM.
Verify that the Run As user account configuration supports SSPM risky account scans.

When you configure the External Client App, you will specify a Run As user, which provides the security context for the External Client App. For the risky account scan to work correctly, SSPM requires that you enable a particular setting for the Run As user on the Single Sign-on Settings page. This step is required only for the risky account scan; other scans will be unaffected.
1. Log in to the Salesforce account that you will specify as the External Client App's Run As user.
2. From the setup home page in Salesforce, navigate to the Single Sign-on Settings page. To navigate to this page, select IdentitySingle Sign-on Settings.
3. On the Single Sign-on Settings page, locate the Delegated Authentication area, and make sure that the Disable login with Salesforce credentials checkbox is selected.
  
  If the Disable login with Salesforce credentials checkbox is not already selected, make sure that you understand the implications of selecting this checkbox. Modifying any setting on your Salesforce Single Sign-on Settings page might affect your users.
Configure your Salesforce session settings to support API integrations.

For API integrations to work correctly, SSPM requires that you disable session IP locking within your Salesforce organization configuration. Disabling this organization-wide setting prevents Salesforce from terminating API connections if SSPM rotates IP addresses during its scans.
1. Log in to a Salesforce account assigned to the System Administrator Profile.
2. Navigate to your Setup page. To do this, click the settings icon (gear icon) in the upper-right corner of the page, and select Setup.
3. From the Setup page's left navigation pane, select SecuritySession Settings. You can also search for Session Settings in the Quick Find box.
4. On the Session Settings page, make sure that the Lock sessions to the IP address from which they originated checkbox is not selected. If necessary, clear the checkbox.
Create an External Client App in Salesforce.

Creating an External Client App establishes a secure identity for SSPM within your Salesforce environment. This identity enables Salesforce to recognize SSPM and authorize its API requests.
1. Identify the Salesforce user account that you will use to create your External Client App.
  Required Permissions: Accounts that meet either one of the following requirements can create an External Client App and access its Consumer Key and Consumer Secret:
  Accounts assigned to the System Administrator Profile.
  Accounts whose permission set includes the Create, edit, and delete External Client Apps permission.
2. Log in to the Salesforce account that you identified.
3. Navigate to your Setup page. To do this, click the settings icon (gear icon) in the upper-right corner of the page, and select Setup.
4. Navigate to the External Client App Manager page. To navigate to this page, from the Setup page's left navigation pane, select Apps External Client AppsExternal Client App Manager. These items appear under the PLATFORM TOOLS section of the menu.
5. On the External Client App Manager page, click New External Client App.
6. Fill in the fields to define your External Client App.
  Under Basic Information, take the following actions:
  In the External Client App Name field, specify a meaningful name, such as SSPM Connector. Salesforce will also automatically format this name for system use (such as replacing spaces with underscores) in the API Name field. Using a clear, descriptive name ensures that SSPM activity is easily identifiable in your Salesforce audit logs and describes the External Client App's purpose to other administrators.
  In the Contact Email field, enter a valid email address that Salesforce can use to contact you or your support team regarding this integration. We recommend using a shared administrative or security team email alias to ensure that these alerts are seen even if a specific individual leaves the organization.
  For the Distribution State, select Local. This setting indicates that your External Client App will be private to your organization, and not packaged for distribution to other organizations.
  Under API (Enable OAuth Settings), take the following actions:
  Select the Enable OAuth checkbox.
  Selecting the Enable OAuth checkbox expands the API (Enable OAuth Settings) section to show additional fields.
  In the Callback URL field, specify the following callback URL:
  https://login.salesforce.com/services/oauth2/callback
  This URL acts as a secure "return address" that allows Salesforce to safely complete the authentication process with SSPM. Ensure you enter the URL exactly as shown, as this field is case-sensitive.
  In the Available OAuth Scopes list, select the following scopes and click the Add arrow to move them to the Selected OAuth Scopes list:
  Manage user data via APIs (api)
  Perform requests at any time (refresh_token, offline_access)
  
  Select the following checkboxes:
  In the Flow Enablement section:
  Enable Client Credentials Flow
  In the Security section:
  Require secret for Web Server Flow
  Require secret for Refresh Token Flow
  Require Proof Key for Code Exchange (PKCE) extension for Supported Authorization Flows
7. Create your External Client App.
  
  Salesforce creates the External Client App, and displays a Detail page for the External Client App.
Configure access policies for your External Client App.

Now that you have created the External Client App, you must define its security policies. These settings enable the authorization flow for your SSPM users, and specify which user account will provide the underlying permissions for SSPM’s activity.
1. On the External Client App Detail page, select the Policies tab and Edit.
2. Expand the OAuth Policies section.
3. Under Plugin Policies, set the Permitted Users to All users may self-authorize.
4. Under OAuth Flows and External Client App Enhancements, select the Enable Client Credentials Flow checkbox and specify the Run As user.
  Required Permissions: Accounts the meet either of the following requirements can serve as the Run As user.
  
  Accounts assigned to the System Administrator Profile.
  Accounts whose permission set includes the following permissions:
  API Enabled
  View Health Check
  Customize Application
  Manage Sharing
  Manage Users
  Download AppExchange Packages
  
  During onboarding, you will specify whether you want SSPM to connect with Read Permissions only or with Read and Write permissions. The Run As user requires the Download AppExchange Packages permission only if you plan to grant SSPM full Read and Write permissions during onboarding.
  
  View Event Log Files
  View Setup and Configuration
  View Roles and Role Hierarchy
  Assign Permission Sets
  Modify Metadata Through Metadata API Functions
5. Under App Authorization, set the Refresh Token Policy to Expire refresh token after a specific time. Use the Refresh Token Validity Period and Refresh Token Validity Unit fields to set the expiration period to 365 days.
6. Under App Authorization, set the IP Relaxation policy to Relax IP Restrictions.
7. Save your changes.
Copy the credentials (Client ID and Client Secret) for your External Client App.

SSPM will use these credentials to establish a secure connection to your Salesforce instance.
1. On the External Client App Detail page, select the Settings tab.
2. Under the OAuth Settings, locate the App Settings and click Consumer Key and Secret. Salesforce might require you to provide a one-time passcode before continuing.
  
  Salesforce displays the Consumer Key (Client ID) and Consumer Secret (Client Secret).
3. Copy the Client ID and Client Secret and paste them into a text file.
  
  Do not continue to the next step unless you have copied the Client ID and Client Secret. You must provide this information to SSPM during the onboarding process.
Connect SSPM to your Salesforce instance.

In SSPM, complete the following steps to enable SSPM to connect to your Salesforce instance.
1. Log in to Strata Cloud Manager.
2. Select ConfigurationSaaS SecurityPosture SecurityApplicationsAdd Application and click the Salesforce tile.
3. On the Posture Security tab, Add New instance.
4. Select the option for External Client App.
5. Enter your Instance URL and the application credentials (Client ID and Client Secret).
6. Specify whether you want SSPM to connect with Read Permissions only or with Read and Write Permissions.
  The onboarding page lists the API scopes that SSPM will access to complete its various scans and to perform remediation.
7. Connect.