Connections > Salesforce Data Cloud connection properties > Connect to Salesforce Data Cloud
  

Connect to Salesforce Data Cloud

Let's configure the Salesforce Data Cloud connection properties to connect to Salesforce Data Cloud.

Before you begin

Before you get started, create a connected app for the Data Cloud Ingestion API in Salesforce Data Cloud, with the required scopes.
You need at a minimum the Manage user data via APIs (api) and Manage Data Cloud Ingestion API data (cdp_ingest_api) scopes for Salesforce Data Cloud.
To load data, you also need to create an ingestion API data stream.
Configure your connected app and get the consumer key and consumer secret to generate the access token.
For more information about these steps, see the Salesforce Data Cloud documentation.

Connection details

The following table describes the basic connection properties:
Property
Description
Connection Name
Name of the connection.
Each connection name must be unique within the organization. Connection names can contain alphanumeric characters, spaces, and the following special characters: _ . + -,
Maximum length is 255 characters.
Description
Description of the connection. Maximum length is 4000 characters.
Type
Salesforce Data Cloud
Use Secret Vault
Stores sensitive credentials for this connection in the secrets manager that is configured for your organization.
This property appears only if secrets manager is set up for your organization.
This property is not supported by Data Ingestion and Replication and the Data Access Management services.
When you enable the secret vault in the connection, you can select which credentials that the Secure Agent retrieves from the secrets manager. If you don't enable this option, the credentials are stored in the repository or on a local Secure Agent, depending on how your organization is configured.
Note: If you’re using this connection to apply data access policies through pushdown or proxy services, you cannot use the Secret Vault configuration option.
For information about how to configure and use a secrets manager, see Secrets manager configuration.
Runtime Environment
The name of the runtime environment where you want to run tasks.
Select a Secure Agent or Hosted Agent.
Authentication Type
The authentication method to connect to Salesforce Data Cloud.
Default is OAuth 2.0 client credentials.
Access Token URL
The endpoint where OAuth 2.0 requests are sent to obtain an access token to connect to the Salesforce Data Cloud instance.
The format of the URL is: https://<Salesforce Data Cloud organization ID>my.salesforce.com/services/oauth2/token
Client ID
Client ID of your application to connect to Salesforce Data Cloud.
Client Secret
The client secret associated with the client ID.
Access Token
The access token value.
Click Generate Access Token to populate the access token value.

Advanced settings

The following table describes the advanced connection properties:
Property
Description
Retry Count
The total number of retries to get the response from the Salesforce Data Cloud endpoint.
Enter a positive integer.
Default is 3.
Retry Interval
The time in milliseconds to wait before the Salesforce Data Cloud connection makes another attempt to receive a response.
Enter a positive integer.
Default is 3000 milliseconds.
Advanced Properties
Additional connection properties that you can configure in the Salesforce Data Cloud connection such as retry status codes, connection timeouts, read timeouts, and write timeouts.
Enter each property in the key=value format, separated by an ampersand and colon (&:). Timeout values must be a positive integer.
Default is okhttp.retryStatusCodes=429,500,502,503,504&: okhttp.connectTimeout=30&:okhttp.readTimeout=30&:okhttp.writeTimeout=30.