Version 23.4.8843

• Add the Salesforce Connector
• Authenticate to Salesforce
  • Basic
  • OAuth
  • OAuthPassword
  • OAuthJWT
  • OneLogin
  • PingFederate
  • OKTA
  • ADFS
  • AzureAD
• Complete Your Connection
• More Information

You can use the Salesforce connector from the CData Sync application to capture data from Salesforce and move it to any supported destination. To do so, you need to add the connector, authenticate to the connector, and complete your connection.

Add the Salesforce Connector

To enable Sync to use data from Salesforce, you first must add the connector, as follows:

1. Open the Connections page of the Sync dashboard.

2. Click Add Connection to open the Select Connectors page.

3. Click the Sources tab and locate the Salesforce row.

4. Click the Configure Connection icon at the end of that row to open the New Connection page. If the Configure Connection icon is not available, click the Download Connector icon to install the Salesforce connector. For more information about installing new connectors, see Connections.

Authenticate to Salesforce

After you add the connector, you need to set the required properties.

On the New Connection page, enter the connection name of your choice.

CData Sync supports authenticating to Salesforce in several ways. Select your authentication method below to proceed to the relevant section that contains the authentication details.

• Basic

• OAuth

• OAuthPassword

• OAuthJWT

• OneLogin

• PingFederate

• OKTA

• ADFS

• AzureAD

Basic

To connect with user credentials and a security token, specify the following settings:

• Auth Scheme: Select Basic.

• User – Enter the username that you use to authenticate to your Salesforce account.

• Password – Enter the password that you use to authenticate to your Salesforce account.

• Security Token – Enter the security token for your Salesforce account. If you do not know your security token, you can reset it as follows:

  1. Open your personal information page on the https://www.salesforce.com/ website.

  2. Click the link to reset your security token. The token will be emailed to you.

OAuth

CData Sync provides an embedded OAuth application with which to connect. To use the application, select OAuth for Auth Scheme. No additional properties are required.

OAuthPassword

To connect with OAuth credentials, specify the following settings:

• Auth Scheme: Select OAuthPassword.

• User – Enter the username that you use to authenticate to your Salesforce account.

• Password – Enter the password that you use to authenticate to your Salesforce account.

• Security Token – Enter the security token for your Salesforce account. If you do not know your security token, you can reset it as follows:

  1. Open your personal information page on the https://www.salesforce.com/ website.

  2. Click the link to reset your security token. The token will be emailed to you.

OAuthJWT

To connect with JWT, specify the following settings:

• Auth Scheme: Select OAuthJWT.

• OAuth JWT Cert – Enter your Java web tokens (JWT) certificate store.

• OAuth JWT Cert Type – Enter the type of key store that contains your JWT Certificate. The default type is PEMKEY_BLOB.

• OAuth JWT Issuer – Enter the issuer of your Java web token. Typically, the issuer is either the client Id or the email address of the OAuth application.

• OAuth JWT Cert Password – Enter the password for your OAuth JWT certificate.

• OAuth JWT Cert Subject – Enter the subject of your OAuth JWT certificate.

• OAuth JWT Subject – Enter the user subject for which the application is requesting delegated access.

OneLogin

To connect with single sign-on (SSO) via OneLogin, specify the following settings:

• Auth Scheme: Select OneLogin.

• User – Enter the username for your PingFederate account.

• Password – Enter the password for your PingFederate account.

• SSO Login URL – Enter the login URL for your single sign-on (SSO) provider.

• SSO Properties – Enter the SSO properties that you want to use(for example, SSOProperty1=Value1;SSOProperty2=Value2;…) .

• SSO Exchange URL – Enter the Salesforce OAuth 2.0 token endpoint for the identity provider (for example, https://MyOrganization.My.SalesforceAcct.com/services/oauth2/token).

PingFederate

To connect with single sign-on (SSO) via PingFederate, specify the following settings:

• Auth Scheme: Select PingFederate.

• User – Enter the username for your OneLogin account.

• Password – Enter the password for your OneLogin account.

• SSO Properties – Enter the single sign-on (SSO) properties that you want to use (for example, SSOProperty1=Value1;SSOProperty2=Value2;…) .

• SSO Exchange URL – Enter the Salesforce OAuth 2.0 token endpoint for the identity provider (for example, https://MyOrganization.My.SalesforceAcct.com/services/oauth2/token).

OKTA

To connect with single sign-on (SSO) via Okta, specify the following properties:

• Auth Scheme: Select OKTA.

• User – Enter the username for your OKTA account.

• Password – Enter the password for your OKTA account.

• SSO Login URL – Enter the login URL for your single sign-on (SSO) provider.

• SSO Properties – Enter the single sign-on (SSO) properties that you want to use (for example, SSOProperty1=Value1;SSOProperty2=Value2;…).

• SSO Exchange URL – Enter the Salesforce OAuth 2.0 token endpoint for the identity provider (for example, https://MyOrganization.My.SalesforceAcct.com/services/oauth2/token).

ADFS

To connect with single sign-on (SSO) via ADFS, specify the following properties:

• Auth Scheme: Select ADFS.

• User – Enter the username for your ADFS account.

• Password – Enter the password for your ADFS account.

• SSO Login URL – Enter the login URL for your single sign-on (SSO) provider.

• SSO Properties – Enter the single sign-on (SSO) properties that you want to use (for example, SSOProperty1=Value1;SSOProperty2=Value2;…).

• SSO Exchange URL – Enter the Salesforce OAuth 2.0 token endpoint for the identity provider (for example, https://MyOrganization.My.SalesforceAcct.com/services/oauth2/token).

AzureAD

To connect with single sign-on via AzureAD, specify the following settings:

• Auth Scheme: Select AzureAD.

• SSO Properties – Enter the single sign-on (SSO) properties that you want to use (for example, SSOProperty1=Value1;SSOProperty2=Value2;…).

• SSO Exchange URL – Enter the Salesforce OAuth 2.0 token endpoint for the identity provider (for example, https://MyOrganization.My.SalesforceAcct.com/services/oauth2/token).

• OAuth Client Id – Enter the client Id that you were assigned when you registered your application with an OAuth authorization server.

• OAuth Client Secret – Enter the client secret that you were assigned when you registered your application with an OAuth authorization server.

Complete Your Connection

To complete your connection:

1. Specify the following properties:

   • API Version (optional) - Enter your API version. The default version is 56.0.

   • Login URL (optional) - Enter your login URL for Salesforce.

   • Use Sandbox (optional) - Set Use Sandbox to True if you want to connect to a sandbox account. Otherwise, leave the default setting (False).

2. Define advanced connection settings on the Advanced tab. (In most cases, though, you should not need these settings.)

3. If you authenticate with OAuth, OAuthPassword, OAuthJWT, or AzureAD, click Connect to Salesforce to connect to your Salesforce account.

4. Click Create & Test to create your connection.

More Information

For more information about interactions between CData Sync and Salesforce, see Salesforce Connector for CData Sync.