Salesforce 外部连接

您在此处：

Salesforce 外部连接

使用 Salesforce 外部连接器将数据从另一个 Salesforce 组织同步到 CRM Analytics。外部连接器需要 OAuth 2.0 才能进行服务器到服务器的通信。

备注

从 Summer '27 开始，SOAP API 版本 31.0 到 64.0 中的 SOAP API login() 调用将不再受支持，并且不再可用。有关更多信息，请查看 SOAP API login() 在 SOAP API 版本 31.0 至 64.0 中调用正在停用。

从 Winter '27 版本开始，将不再支持外部连接器中的用户名和密码身份验证设置。

新的外部连接器需要带有客户端 ID 和客户端密码的 OAuth 进行身份验证。如果在贵组织权限中启用 SOAP API login()，使用用户名和密码的现有连接器仍可以正常工作。但是，如果您需要更新现有用户名和密码连接器的凭据，您必须将其转换为使用 OAuth 设置。

Salesforce 输出和外部连接器不支持受限的 API 访问权限。为创建连接器的用户启用“使用任何 API 客户端”权限。有关更多信息，请查看管理 API 访问权限。

要将数据从 CRM Analytics 推送到 Salesforce 组织，请使用 Salesforce 输出连接。

为 OAuth 设置外部客户端应用程序

外部客户端应用程序 (ECA) 提供单点登录 (SSO)，并使用 OAuth 协议授权外部连接。

备注

建议创建单独的 Salesforce 用户帐户，不分配给设置连接的人员。在用户离开您的组织时，可以禁用个人帐户，这会阻止使用该帐户创建的任何连接正常工作。

要为您的组织创建 ECA，从 Salesforce 设置页面中，在快速查找方框中输入外部，然后选择外部客户端应用程序管理器。
单击新建外部客户端应用程序。
输入基本信息。
1. 输入要在外部客户端应用程序管理器中显示的 ECA 的名称。
2. 输入从程序引用您的应用程序时要使用的 API 名称。此字段默认为应用程序名称的版本，并使用下划线代替空格。
3. 如果我们想要联系您或支持团队，输入联系人电子邮件，以供 Salesforce 使用。
4. 为分发状态选择本地。
单击启用 OAuth，以配置 OAuth 策略。
输入应用程序设置。
1. 输入回调 URL。回调 URL 是您嵌入代码的应用程序 URL，该 URL 可以接受从 Salesforce ECA 返回的身份验证。回调 URL 的示例是 https://<3p-domain>/callback.html。
2. 对于 OAUTH 范围，选择通过 API 管理用户数据 (api) 和访问 Analytics REST API 资源 (wave_api)。如果您有其他 OAuth 需求，根据需要选择其他范围。有关更多信息，请查看OAuth 令牌和范围
对于流启用，选择启用客户端凭据流。此流允许服务器之间的交互。有关更多信息，请查看适用于服务器到服务器集成的 OAuth 2.0 客户端凭据流
为了安全起见，请为支持的授权流禁用需要代码交换证明密钥 (PKCE) 扩展。
单击创建。
在“策略”选项卡上，单击编辑。对于 OAuth 流和外部客户端应用程序增强，请确保启用客户端凭据流。输入运行方式的用户电子邮件。此用户必须是有效的执行用户。
在“设置”选项卡上，单击消费者密钥和密码，以复制并保存值。您需要客户端 ID 的使用者密钥值和客户端密码的使用者密码值。

创建连接

在“数据管理器连接”选项卡中单击新建连接。
选择 Salesforce 外部连接器，然后单击下一步。
输入连接器设置。
要验证设置，请单击保存并测试。如果连接失败，CRM Analytics 会显示可能原因。

除非另行说明，否则所有设置需要值。

连接设置	描述
连接名称	使用约定，可让您在区分不同连接。
开发人员名称	连接的 API 名称。此名称不能包含空格。API 名称会在模式中使用，以引用通过此连接提取的数据。您无法在创建连接后更改开发人员名称。
描述	连接器描述。
验证类型	支持的身份验证类型。有效值为 `OAuth`。
用户名	Winter '27 之后不再受支持。用于连接到外部 Salesforce 组织的用户名。如果身份验证类型是密码，则需要此项。
密码	Winter '27 之后不再受支持。通过用户名指定的用户密码。根据您的安全设置，将用户的安全令牌附加到密码的末尾。有关获取安全令牌的信息，请查看重置安全令牌。如果身份验证类型是密码，则需要此项。
客户端 ID	OAuth 连接所需的客户端 ID。该值是外部客户端应用程序中的使用者密钥。
客户端密码	OAuth 连接所需的客户端密码。该值是来自外部客户端应用程序的使用者密码。
API 类型	要使用的 API。选项是适用于 SOAP API 的 `SOAP` 或适用于 Salesforce Bulk API 2.0 的 `BULKV2`（默认）。如果您遇到较大数据对象使用 SOAP API 超时的问题，请使用 Salesforce Bulk API 2.0。
服务 URL	Winter '27 之后不再受支持。外部组织的登录 URL。默认值将使用适用于贵组织的通用 Salesforce 登录 URL。对于增加的安全层，更新此字段以使用贵组织的 My Domain 登录 URL。对于生产组织,使用格式:`https://<MyDomainName.my .salesforce.com/services/Soap/Identifier/VersionNumber.0` 例如： `https://mycompany.my.salesforce.com/services/Soap/u/54.0`
域 URL	外部 Salesforce 组织所需的 My Domain URL。在外部 Salesforce 组织中，转到“设置”中的 My Domain。URL 格式必须是 `https://*.salesforce.com`

筛选同步到 CRM Analytics 的数据

使用筛选器排除同步到 CRM Analytics 筛选器的不必要或敏感数据。筛选器仅将您需要的数据提取到 CRM Analytics 中，从而加快数据同步。

备注如果您预计未来会排除数据，请使用模式筛选器，而不是数据同步筛选器。

在数据管理器中，单击连接选项卡。
选择与要筛选的对象相关联的连接。
单击要筛选的对象的名称。
单击数据同步筛选器。
输入筛选器。
单击保存。

对于 Salesforce 外部连接器，如 SOQL 和 SOSL 参考所述，使用 SOQL WHERE 子句表达式，输入筛选器。例如，"(FiscalQuarter = 2 OR FiscalQuarter = 3) AND Amount > 1000 AND Amount <= 20000"。