本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 连接 Salesforce
<a name="connectors-salesforce"></a>

要将 App Studio 与 Salesforce 连接以使构建者能够在应用程序中访问和使用 Salesforce 资源，您必须在 Salesforce 中创建和配置连接的应用程序，并在 App Studio 中创建 Salesforce 连接器。

**将 Salesforce 与 App Stud**

1. 在 App Studio 的导航窗格中，选择**管理**部分的**连接器**。您将进入一个页面，其中显示了现有连接器的列表，其中包含每个连接器的一些详细信息。

1. 选择 **\+ 创建连接器**。

1. 从连接器类型列表中选择 **Salesforce** 以打开连接器创建页面。

1. 记下**重定向网址**，您将在以下步骤中使用该网址来配置 Salesforce。

1. 下一步是在 Salesforce 中创建一个联网应用程序。在另一个选项卡或窗口中，导航到您的 Salesforce 实例。

1. 在 “快速查找” 框中，搜索，**App Manager**然后选择 “**应用程序管理器**”。

1. 选择 “**新建连接的应用程序**”。

1. 在**已连接的应用程序名称**和 **API 名称**中，输入您的应用程序的名称。它不必与你的 App Studio 应用程序名称相匹配。

1. 根据需要提供联系信息。

1. 在 **API（启用 OAuth 设置）**部分，启用**启用 OAuth 设置**。

1. 在**回调网址**中，输入你之前在 App Studio 中记下的**重定向网址**。

1. 在**选定 OAuth 范围**中，从列表中添加必要的权限范围。App Studio 可以与 Salesforce REST APIs 交互，对五个对象执行 CRUD 操作：客户、案例、联系人、潜在客户和机会。建议添加**完全访问权限（完整）**，以确保您的 App Studio 应用程序具有所有相关的权限或范围。

1. 禁用 “**支持的授权流需要验证密钥进行代码交换 (PKCE) 扩展**” 选项。App Studio 不支持 PKCE。

1. 启**用 Web 服务器流****需要密钥和刷新令牌流**需要密钥以遵循最佳安全实践。

1. App Studio 支持以下两个身份验证流程：
   + **客户凭证流程**：非常适合应用程序在没有用户 server-to-server交互的情况下代表自己操作的交互。例如，列出没有 Salesforce 访问权限的临时员工团队的所有潜在客户信息。
   + **授权码流程**：适用于代表用户行事的应用程序，例如个人数据访问或操作。例如，列出每位销售经理获取或拥有的潜在客户，以便通过此应用程序执行其他任务。
   + 对于客户凭证流程：

     1. 启用 **“启用客户机凭证流**”。查看并确认消息。

     1. 保存应用程序。

     1. 尽管流程中没有用户交互，但您必须选择执行用户。通过选择执行用户，Salesforce 代表该用户返回访问令牌。

        1. 在**应用程序管理器**中，从应用程序列表中选择 App Studio 应用程序的箭头，然后选择**管理**。

        1. 选择 “**编辑策略”**

        1. 在 “**客户凭证流**” 中，添加相应的用户。
   + 对于授权码流程，启用**启用授权码和凭证流程**

1. Salesforce 提供了客户端 ID 和客户端密钥，在以下步骤中，必须使用它们在 App Studio 中配置连接器。

   1. 在**应用程序管理器**中，选择 App Studio 应用程序的箭头，然后选择**查看**。

   1. 在 **API（启用 OAuth 设置）**部分中，选择**管理消费者详细信息**。这可能会发送一封电子邮件以获取验证密钥，您需要输入验证密钥进行确认。

   1. 记下**消费者密钥**（客户端 ID）和**消费者密钥**（客户机密）。

1. 返回 App Studio，通过填写以下字段来配置和创建您的连接器。

1. 在**名称**中，输入您的 Salesforce 连接器的名称。

1. 在**描述**中，输入您的 Salesforce 连接器的描述。

1. 在**基本网址**中，输入您的 Salesforce 实例的基本网址。它应该看起来像这样:`https://{{hostname}}.salesforce.com/services/data/v60.0`，替换{{hostname}}为你的 Salesforce 实例名称。

1. 在 “**身份验证方法**” 中，确保选择 **OAuth 2.0**。

1. 在 **OAuth 2.0 Flow** 中，选择 OAuth 身份验证方法并填写相关字段：
   + 选择 “**客户凭证流**”，以便在代表自己行事的应用程序中使用以进行 system-to-system集成。

     1. 在 “**客户端 ID**” 中，输入之前从 Salesforce 获得的使用**者密钥**。

     1. 在**客户密钥**中，输入之前从 Salesforce 获得的**消费者机密**。

     1. 在**访问令牌 URL** 中，输入 OAuth 2.0 令牌端点。它应该看起来像这样:`https://{{hostname}}/services/oauth2/token`，替换{{hostname}}为你的 Salesforce 实例名称。有关更多信息，请参阅 [Salesforce OAuth 终端节点](https://help.salesforce.com/s/articleView?id=sf.remoteaccess_oauth_endpoints.htm&type=5)文档。

     1. 选择 “**验证连接**” 以测试身份验证和连接。
   + 选择 “**授权代码流**”，以便在代表用户执行操作的应用程序中使用。

     1. 在 “**客户端 ID**” 中，输入之前从 Salesforce 获得的使用**者密钥**。

     1. 在**客户密钥**中，输入之前从 Salesforce 获得的**消费者机密**。

     1. 在**授权 URL** 中，输入授权端点。它应该看起来像这样:`https://{{hostname}}/services/oauth2/authorize`，替换{{hostname}}为你的 Salesforce 实例名称。有关更多信息，请参阅 [Salesforce OAuth 终端节点](https://help.salesforce.com/s/articleView?id=sf.remoteaccess_oauth_endpoints.htm&type=5)文档。

     1. 在**访问令牌 URL** 中，输入 OAuth 2.0 令牌端点。它应该看起来像这样:`https://{{hostname}}/services/oauth2/token`，替换{{hostname}}为你的 Salesforce 实例名称。有关更多信息，请参阅 [Salesforce OAuth 终端节点](https://help.salesforce.com/s/articleView?id=sf.remoteaccess_oauth_endpoints.htm&type=5)文档。

1. 在**操作**中，选择您的连接器将支持的 Salesforce 操作。此列表中的操作是预定义的，代表 Salesforce 中的常见任务，例如创建、检索、更新或删除常用对象中的记录。

1. 选择**创建**。新创建的连接器将出现在**连接**器列表中。