View a markdown version of this page

连接到 Salesforce - AWS 应用程序工作室

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

连接到 Salesforce

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

将 Salesforce 与 App Studio 连接起来

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

  2. 选择 + 创建连接器。

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

  4. 记下重定向网址，你将在以下步骤中使用它来配置 Salesforce。

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

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

  7. 选择 “新建联网应用程序” 。

  8. 在关联的应用程序名称和 API 名称中，输入应用程序的名称。它不必与您的 App Studio 应用程序名称相匹配。

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

  10. 在 API（启用 OAuth 设置）部分中，启用启用 OAuth 设置。

  11. 在 “回调 URL” 中，输入您之前在 App Studio 中记录的重定向网址。

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

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

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

  15. App Studio 支持以下两种身份验证流程：

    • 客户端凭证流程：非常适合服务器与服务器的交互，在这种交互中，应用程序无需用户交互即可自行运行。例如，列出没有 Salesforce 访问权限的临时员工团队的所有潜在客户信息。

    • 授权码流程：适用于代表用户执行操作的应用程序，例如个人数据访问或操作。例如，列出每位销售经理通过此应用程序获取或拥有的用于执行其他任务的潜在客户。

    • 对于客户凭证流程：

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

      2. 保存应用程序。

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

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

        2. 选择 “编辑策略”

        3. 在客户机凭证流程中，添加相应的用户。

    • 对于授权码流程，启用 “启用授权码和凭证流”

  16. Salesforce 提供客户端 ID 和客户端密钥，在以下步骤中，必须使用这两个标识和客户端密钥在 App Studio 中配置连接器。

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

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

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

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

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

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

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

  21. 在身份验证方法中，确保选择 OAuth 2.0 。

  22. 在 OAuth 2.0 流程中，选择 OAuth 身份验证方法并填写相关字段：

    • 选择 “客户机凭证流程”，用于代表其自行运行的应用程序，进行系统间集成。

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

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

      3. 在访问令牌 URL 中，输入 OAuth 2.0 令牌端点。它应该看起来像这样:https://hostname/services/oauth2/token，替换hostname为你的 Salesforce 实例名称。有关更多信息，请参阅 Salesforce OAuth Endpoints 文档。

      4. 选择 “验证连接” 以测试身份验证和连接。

    • 选择授权码流程，用于代表用户执行操作的应用程序。

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

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

      3. 在授权 URL 中，输入授权端点。它应该看起来像这样:https://hostname/services/oauth2/authorize，替换hostname为你的 Salesforce 实例名称。有关更多信息，请参阅 Salesforce OAuth Endpoints 文档。

      4. 在访问令牌 URL 中，输入 OAuth 2.0 令牌端点。它应该看起来像这样:https://hostname/services/oauth2/token，替换hostname为你的 Salesforce 实例名称。有关更多信息，请参阅 Salesforce OAuth Endpoints 文档。

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

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