Salesforce

Foundry的Salesforce连接器允许您在Salesforce和Foundry数据集之间同步数据。

支持的功能

数据模型

该连接器将所有可用的标准 ↗和自定义Salesforce对象建模为Foundry数据集。模式是动态检索的。探索视图允许您浏览数据模型并预览Salesforce对象导入到Foundry后的显示方式。

数据类型映射

连接器将Salesforce API类型映射到以下Foundry字段类型：

性能和限制

该连接器利用了Salesforce SOAP API ↗，其受限于Salesforce SOAP API调用限制 ↗。

设置

1. 打开数据连接应用程序，选择屏幕右上角的**+ 新建源**。
2. 从可用的连接器类型中选择Salesforce。
3. 选择使用直接连接通过互联网连接，或选择通过中介代理连接。
4. 按照其他配置提示继续设置连接器，使用下面各节中的信息。

了解更多关于在Foundry中设置连接器的信息。

认证

选择一种凭证方法来验证您的Salesforce连接：JWT词元或用户名-密码。

JWT词元

您可以使用OAuth 2.0 JSON Web词元 (JWT) 持有者流 ↗来授权Foundry访问数据，而无需在每次请求时进行交互式登录。

要启用JWT认证，您必须生成一个证书，在创建连接的应用程序时上传该证书，然后执行一次性授权集成用户。

第1部分：生成证书

首先，创建一个Salesforce用户并验证其是否具有API和任何您希望修改的Salesforce对象的访问权限。确保您能够以集成用户身份登录，因为在后续步骤中您需要以该用户身份进行授权。

现在，创建一个JWT证书。Salesforce JWT持有者流 ↗需要一个X.509证书和关联的私钥。要生成私钥，请在命令行使用openssl并运行以下命令：

1. 生成x.509公钥和私钥对：

   Copied!
   1
   2
   % openssl genrsa 1024 | openssl pkcs8 -topk8 -inform PEM -out key.pem -nocrypt
   % openssl req -new -x509 -key key.pem -out cert.pem -days 3650

2. 将证书导出到PFX存储，转换为Base64，并复制到剪贴板：

   Copied!
   1
   % openssl pkcs12 -export -in cert.pem -inkey key.pem | openssl base64 | pbcopy

第2部分：创建连接的应用程序

在Salesforce Lightning Experience设置页面，滚动浏览左侧边栏以选择应用程序 > 应用程序管理器条目，位于平台工具部分。在应用程序管理器页面，通过选择新建连接应用程序来创建一个新的连接应用程序。

在应用程序创建页面的基本信息部分，填写以下字段：

1. 连接应用程序名称
2. API名称
3. 电子邮件

然后，按照以下步骤设置**API（启用OAuth设置）**部分：

1. 勾选启用OAuth设置。
2. 在回调URL中填写https://localhost:12345。这将在后续使用。
3. 勾选使用数字签名并上传上面生成的cert.pem X.509证书文件。
4. 从可用的OAuth范围中选择api、offline_access和refresh_token。
5. 勾选要求Web服务器流的秘密。

忽略其他部分，通过选择保存然后在下一页上选择确认来完成连接应用程序的创建。在尝试使用连接的应用程序之前，请等待十分钟。

一旦连接的应用程序创建完成，请在API（启用OAuth设置）部分下保存消费者密钥（例如，3MVG9FG3dv...）到一个安全的地方。

第3部分：授权用户

使用以下选项之一授权集成用户：

• **执行一次性授权：**通过在浏览器中执行登录流来为集成用户授权连接应用程序：
  1. 导航到以下Salesforce URL：https://<salesforce-url>/services/oauth2/authorize?client_id=<CONSUMER_KEY>&redirect_uri=<CALLBACK_URL>&scope=api%20offline_access%20refresh_token&response_type=code&response_mode=query&nonce=bebmwgu22zh
     • 用您的连接应用程序消费者密钥替换<CONSUMER_KEY>，并用您在API配置步骤中输入的URL替换<CALLBACK_URL>。
     • 用您的Salesforce实例URL替换<salesforce-url>（<site>.my.salesforce.com）。
  2. 以集成用户身份完成登录流，必要时选择使用自定义域。在下一页上选择允许，以允许连接应用程序代表您执行指定范围的操作。确保显示的是集成用户的用户名，而不是您的个人帐户用户名。
  3. 然后，您将被重定向回https://localhost:12345（回调URL）。由于回调URL不是真实的，浏览器将显示预期的“未找到”错误。
• 通过遵循Salesforce指导 ↗预授权用户来更改允许的用户策略为管理员批准的用户已预授权。预授权完成后，返回连接应用程序配置页面为连接应用程序授予访问权限。可以将访问权限授予个人集成用户配置文件，或包含集成用户的权限集。

继续使用以下JWT认证配置选项在Foundry中设置Salesforce连接器：

用户名-密码

要使用用户名-密码 ↗认证方法连接到Salesforce，您必须在Salesforce中创建一个服务用户帐户和连接的应用程序。然后，将两者的凭证添加到Salesforce连接器中。

按照以下步骤启用用户名-密码认证流。

1. 创建一个Salesforce用户并验证其是否具有API和任何您希望修改的Salesforce对象的访问权限。请记录用户的用户名和密码以备将来参考。

2. 创建连接的应用程序：

   1. 在Salesforce Lightning Experience设置页面，滚动浏览左侧边栏以选择应用程序 > 应用程序管理器条目，位于平台工具部分。在应用程序管理器页面，通过选择新建连接应用程序来创建一个新的连接应用程序。

   2. 在应用程序创建页面的基本信息部分，填写以下字段：

      1. 连接应用程序名称
      2. API名称
      3. 电子邮件

   3. 然后，按照以下步骤设置**API（启用OAuth设置）**部分：

      1. 勾选启用OAuth设置。
      2. 在回调URL中填写https://localhost:12345。此字段是配置所需的，但回调URL将不被使用。
      3. 从可用的选定OAuth范围中选择完全访问（full），以允许访问对活动用户可访问的所有数据。

   4. 忽略其他部分，通过选择保存然后在下一页上选择确认来完成连接应用程序的创建。在尝试使用连接的应用程序之前，请等待两到十分钟。

一旦连接的应用程序创建完成，请从应用程序管理器页面导航到它。选择管理，然后选择编辑策略。在OAuth政策 > 允许的用户下选择所有用户可以自我授权。

用户名-密码认证方法支持以下配置选项：

网络

如果直接连接正在运行您的Salesforce连接器，您必须添加一个网络出口策略以白名单连接。

选择添加现有策略，或创建一个新策略。

要为Salesforce白名单直接连接，请添加以下策略：

• 登录URL：需要DNS，端口443（HTTPS），以及以下之一：

  • login.salesforce.com（生产） 或
  • test.salesforce.com（沙盒）

• 实例URL：需要DNS用于<site>.my.salesforce.com，端口443（HTTPS）。

证书和私钥

SSL连接验证服务器证书。通常，SSL验证通过证书链进行；默认情况下，代理和直接连接运行时信任大多数行业标准证书链。如果您正在连接的服务器有一个自签名证书，或者在验证期间有TLS拦截，连接器必须信任该证书。了解更多关于在数据连接中使用证书的信息。

配置选项

Salesforce连接器支持以下配置选项：

从Salesforce同步数据

使用探索视图同步表。编辑同步时提供其他配置选项。

增量

在使用Salesforce连接器进行增量同步时，如果增量列值大于或等于先前观察到的最大值，则会同步新数据。虽然此行为对于同步数据的精确性和正确性是必需的，但会导致输出数据集中出现重复行。增量管道应始终包含一个去重步骤。

筛选

您可以向同步配置添加行筛选以排除不符合特定标准的数据。 使用条件树定义您的筛选：

• 逻辑运算符：
  • ALL：要求嵌套在下面的所有节点为true。
  • ANY：要求至少一个嵌套节点为true。
• 条件：
  • 从可用列列表中选择。
  • 根据列类型选择适当的运算符。
  • 设置一个值以与所选列进行比较。

确保保存您的配置以将其应用于同步。

迁移

如果您已经有一个Salesforce连接器，您可能正在运行旧版本。要识别您的连接器版本，请迁移到连接设置 > 连接详细信息。如果源配置显示一个带有type: salesforce字段的自定义YAML部分，您正在使用旧版Salesforce连接器。您必须迁移到最新版本以获得Palantir的支持（超出错误修复的范围）。

迁移连接器

1. 打开数据连接应用程序，选择屏幕右上角的**+ 新建源**。
   1. 从可用的连接器类型中选择Salesforce。
   2. 选择使用直接连接通过互联网连接，或选择通过中介代理连接。
   3. 按照其他配置提示继续设置连接器，使用下面各节中的信息。
2. 配置认证以匹配旧源。在旧源配置中，找到自定义YAML中的auth-method或authentication-method块。
   • 如果type: oauth2-jwt，使用JWT认证配置新源：
     • 自定义YAML中的claim-sub变为新连接器配置中的用户名。
     • x509-cert导出为PFX，然后Base64编码并成为证书。了解更多关于证书的信息，请参见上面的JWT认证部分。
   • 如果PFX是密码保护的，打开证书是密码保护的并输入证书密码。
     • 自定义YAML中的claim-iss变为新连接器配置中的消费者密钥。
   • 如果type: oauth2-username-password，使用用户名-密码认证配置新源：
     • 自定义YAML中的username变为新连接器配置中的用户名。
     • 自定义YAML中的password变为新连接器配置中的密码。
     • 旧源上的client-id和client-secret属性在新连接器中不需要。
3. 配置其他属性：
   • 自定义YAML中的auth-url变为新连接器配置中的登录URL。
   • 如果自定义YAML中的auth-url值为test.salesforce.com，则在新连接器配置中打开是Salesforce沙盒帐户。

迁移同步

配置新的Salesforce连接器后，为旧连接器之前同步的对象创建同步。使用探索视图一次性批量同步多个对象并创建新的数据集。

您必须迁移下游管道以使用新的同步数据集。一旦确认没有其他消费者需要旧版数据集，您可以删除数据集、相关同步和连接。使用数据沿袭查找旧版数据集在您的环境中的使用位置。