本分步指南解释了如何配置 Salesforce,以允许 BuiltWith 使用 Salesforce Lightning Experience 同步结果。
您必须是 Salesforce 系统管理员,并且授权 BuiltWith 的 Salesforce 用户必须具有 API 访问权限和更新您要同步的记录和字段的权限。
已经在使用 BuiltWith Salesforce Sync 了吗?如果您的同步功能正常,则无需执行任何操作。您无需更改 Salesforce 设置或重新连接。现有连接将继续使用其当前配置。运行常规同步不会更改您的连接设置。
如果您想在现有连接上启用以下附加安全设置,请先使用更新后的连接流程,从 BuiltWith 的 Salesforce 配置页面重新进行身份验证。授权成功后,在 Salesforce 中启用这些设置。您的 BuiltWith 映射和同步设置将保留。策略更改后,Salesforce 可能会要求您重新授权。
1. 配置您的 Salesforce 应用程序在 Salesforce 设置中,打开您将与 BuiltWith 一起使用的应用程序的 OAuth 设置。根据您的 Salesforce 组织,这可能是“已连接应用程序”或“外部客户端应用程序”,可用标签可能有所不同。如果 Salesforce 不提供创建新的“已连接应用程序”选项,请使用具有等效 OAuth 设置的“外部客户端应用程序”。
已连接应用名称/外部客户端应用名称:BuiltWith Hook
API 名称:BuiltWith_Hook
联系邮箱:support@builtwith.com
Logo 图片网址:https://builtwith.com/img/salesforce/200x125-bw.webp
图标网址:https://builtwith.com/img/salesforce/32x32-bw.webp
信息网址:https://kb.builtwith.com/category/salesforce
描述:BuiltWith 集成钩子
请在相应字段中填写这些信息。
2. 启用 OAuth勾选
“启用 OAuth 设置”或等效的 OAuth 选项。
回调 URL :https://builtwith.com/cb.asmx
请完全按照所示内容输入回调 URL。
添加以下 OAuth 范围:
访问身份 URL 服务(ID、个人资料、电子邮件、地址、电话号码)完全访问权限(完整)随时代表您执行请求(refresh_token、offline_access) 3. 为新连接设置安全选项启用以下选项(如有):
要求对支持的授权流程进行代码交换密钥验证 (PKCE) 扩展Web 服务器流需要密钥刷新令牌流程需要密钥启用刷新令牌轮换BuiltWith 支持使用 S256 协议的 PKCE,并在 Salesforce 颁发刷新令牌时保存这些令牌。您不再需要关闭 PKCE 即可创建新的 BuiltWith 连接。即使您的 Salesforce 应用不需要 PKCE 或刷新令牌轮换,连接也能正常工作。
4. 连接 BuiltWith保存 Salesforce 应用设置并获取其 Consumer Key 和 Consumer Secret。请务必妥善保管 Secret。
在 BuiltWith 中打开 Salesforce 配置页面。输入消费者密钥、消费者密钥和 Salesforce 登录主机名,然后选择
身份验证并在 Salesforce 中完成授权。
返回 BuiltWith 以验证您的 Salesforce 字段并完成同步配置。如果您是重新连接,则现有映射和同步设置将被保留。
可选安全策略刷新令牌 IP 允许列表要使用
“强制刷新令牌 IP 允许列表” ,请在启用该设置之前,添加以下所有四个 BuiltWith 出站 IPv4 地址:
15.235.50.228
51.161.84.56
15.235.53.29
15.235.50.223
如果 Salesforce 要求输入起始地址和结束地址,请在每个条目的两个字段中输入相同的 IP 地址。授权和令牌刷新都必须来自允许的地址。启用此设置后,请验证您的 BuiltWith 连接并确认计划的同步成功。在依赖允许列表之前,请联系 support@builtwith.com 以安排 IP 地址更改通知。
刷新令牌过期时间您可以应用组织的刷新令牌过期策略,包括在 Salesforce 允许的情况下应用 90 天的策略。Salesforce 也可能应用更短的非活动限制。当刷新令牌过期或访问权限被撤销时,同步将无法继续,直到您从 BuiltWith 的 Salesforce 配置页面重新进行身份验证。重新连接将保留您的 BuiltWith 映射和同步设置。
DPoP BuiltWith Salesforce Sync 目前不支持所有权证明 (DPoP)。请勿为此集成启用对 DPoP 绑定令牌的要求。
Salesforce 文档已连接应用的 OAuth 设置外部客户端应用程序的 OAuth 设置刷新令牌流和轮换刷新令牌 IP 允许列表刷新令牌不活动限制