Set up a Salesforce v2 connector
This is an updated and improved version of the Salesforce connector! If you’re setting up Salesforce with ConductorOne for the first time, you’re in the right place.
Availability
ConductorOne only integrates with the Salesforce editions with API access: Salesforce Enterprise, Unlimited, Developer, and Performance editions.
You cannot use this connector successfully with Group or Essentials editions, or with Professional edition without an API add-on.
Learn more about which Salesforce editions support API access in the Salesforce documentation.
Capabilities
Sync user identities from Salesforce to ConductorOne
Resources supported:
- Groups
- Roles
- Permission sets
- Profiles
Provisioning supported:
- Groups
- Roles
- Permission sets
- Profiles
Add a new Salesforce connector
This task requires either the Connector Administrator or Super Administrator role in ConductorOne.
In ConductorOne, click Connectors > Add connector.
Search for Salesforce v2 and click Add.
Choose how to set up the new Salesforce connector:
Add the connector to a currently unmanaged app (select from the list of apps that were discovered in your identity, SSO, or federation provider that aren’t yet managed with ConductorOne)
Add the connector to a managed app (select from the list of existing managed apps)
Create a new managed app
Do you SSO into Salesforce using your identity, SSO, or federation provider? If so, make sure to add the connector to the unmanaged Salesforce app that was created automatically when you integrated your provider with ConductorOne, rather than creating a new managed app.
Set the owner for this connector. You can manage the connector yourself, or choose someone else from the list of ConductorOne users. Setting multiple owners is allowed.
A Salesforce connector owner must have the following permissions:
- Connector Administrator or Super Administrator role in ConductorOne
- A Salesforce user account with a profile that includes the API Enabled permission (this permission is included by default in the Standard User and System Administrator profiles)
- Click Next.
Next steps
If you are the connector owner, proceed to Configure your Salesforce connector for instructions on integrating Salesforce with ConductorOne.
If someone else is the connector owner, ConductorOne will notify them by email that their help is needed to complete the setup process.
Configure your Salesforce connector
A user with the Connector Administrator or Super Administrator role in ConductorOne and a Salesforce user account with a profile that includes the API Enabled permission must perform this task.
Step 0: Enable API access for your Salesforce user
Before you begin, make sure that the Salesforce user who will set up the integration with ConductorOne has a profile that includes the API Enabled permission. This permission is included by default in the Standard User and System Administrator profiles.
To edit a different profile so that it includes the API Enabled permission:
Log into Salesforce as an Administrator.
Click the gear icon and select Setup.
Search for “profiles” and select Profiles from the search results.
In the User Profiles list, locate the user profile you want to add the permission to and click Edit.
Find the Administrative Permissions section of the page and click to select API Enabled.
Click Save.
Your user’s profile can now access Salesforce APIs, and you’re ready to begin the integration process.
Step 1: Locate your Salesforce domain
Log into the Salesforce admin panel and copy the URL from your browser. We’ll use this in Step 2.
ConductorOne integrates with domains that use one of the following Salesforce URL structures:
my.salesforce.com
sandbox.my.salesforce.com
test.salesforce.com
lightning.force.com
develop.lightning.force.com
sandbox.lightning.force.com
Step 2: Set up the Salesforce connector
In ConductorOne, navigate to the Salesforce connector by either:
Clicking the Set up connector link in the email you received about configuring the connector.
Navigate to Connectors > Salesforce v2 (if there is more than one Salesforce v2 listed, click the one with your name listed as owner and the status Not connected).
Find the Settings area of the page and click Edit.
Select your method of authenticating to Salesforce and click either OAuth or Username and password.
If you chose OAuth:
In the Domain field, enter the Salesforce domain you looked up in Step 1.
Optional. Check the box to tell ConductorOne to use Salesforce usernames as the email addresses for your organization’s accounts. This option is especially helpful if your organization uses multiple service accounts that all share a
noreply@salesforce.com
email address.Click Login with OAuth.
Log in and authorize ConductorOne with your Salesforce instance.
You will then be redirected back to the Salesforce setup page in ConductorOne, where you’ll see an authorization message.
Click Save.
If you chose Username and password:
Enter your Salesforce username and password in the top two fields.
Enter your Salesforce security token in the Security token field. If trusted IP is configured on your user, entering this token is optional. If needed, refer to Reset Your Security Token in the Salesforce documentation.
In the Domain field, enter the Salesforce domain you looked up in Step 1.
Optional. Check the box to tell ConductorOne to use Salesforce usernames as the email addresses for your organization’s accounts. This option is especially helpful if your organization uses multiple service accounts that all share a
noreply@salesforce.com
email address.Click Save.
The connector’s label changes to Syncing, followed by Connected. You can view the logs to ensure that information is syncing.
That’s it! Your Salesforce connector is now pulling access data into ConductorOne.
Configure the Salesforce integration using Terraform
As an alternative to the integration process described above, you can use Terraform to configure the integration between Salesforce and ConductorOne.
See the ConductorOne Salesforce integration resource page in the ConductorOne Terraform registry for example usage and the full list of required and optional parameters.
Troubleshooting the Salesforce integration
When I try to log in with OAuth, I see a “This feature is not currently enabled for this user” error
Salesforce returns this error if the user who is logging in with OAuth does not have permission to access the Salesforce APIs:
{"code":2, "message":"error getting info from connectorClient: [simpleforce] Error. http code: 403 Error Message: This feature is not currently enabled for this user. Error Code: FUNCTIONALITY_NOT_ENABLED"}
If you see this message, follow the instructions in Step 0: Enable API access for your Salesforce user and then try logging in again.