配置大文档并推送协议服务

上次更新日期: 2024年3月28日

概述

适用于 Salesforce 的 Adobe Acrobat Sign:大文档和推送协议服务指南介绍了如何配置适用于 Salesforce 的 Acrobat Sign,以针对在 Salesforce 环境外部创建的协议,发送大文档(从发送协议页面发送时大于 4.0 MB,批量发送时大于 9.0 MB)或推送协议。

要建立和使用“大文档”和“推送协议”服务,您必须定义回调环境。 回调环境可用于一或两种服务。 回调环境要求您创建一个新的专用用户和配置文件,以确保:

  • 已知的最低授权权限集有效。
  • 此功能不会因禁用用户而中断。

要建立回调环境并使用“大文档”和“推送协议”服务,您必须完成以下步骤:

验证先决条件

注释

Salesforce 专业版不支持大文档交易或推送协议。

定义回调用户

您必须创建一个专用用户才能为回调过程授予对象权限。 具体操作如下:

使用管理员凭据登录适用于 Salesforce 的 Acrobat Sign 帐户。

导航至设置 > 管理 > 用户 > 配置文件

查找用户配置文件列表中的标准用户,然后为列表选择克隆

在适用于 Salesforce 的 Acrobat Sign 中定义回调用户。

在打开的克隆配置文件页面中,提供一个配置文件名称,然后选择保存

此处的示例配置文件使用“Demo callback user”作为配置文件名称。

在适用于 Salesforce 的 Acrobat Sign 中创建回调用户配置文件。

请按照以下步骤,使用标准 Salesforce 许可证创建新用户:

  1. 在左侧面板中,选择用户。 
  2. 在“用户”页面上,选择新建用户
  3.  在新用户页面上,为用户提供一个直观的名称,分配 Salesforce 许可证,并分配您在上述步骤中创建的配置文件。 选择保存
在适用于 Salesforce 的 Acrobat Sign 中创建新回调用户配置文件。

按照以下步骤,将“Adobe Acrobat Sign 集成用户”权限集添加至回调用户:

  1. 导航至设置 > 管理 > 用户 > 用户。
  2. 选择回调用户的全名链接。
  3. 将鼠标悬停在权限集任务上,然后选择编辑任务

权限集任务页面,执行以下操作:

  1. 可用权限集下,选择 Adobe Acrobat Sign 集成用户
  2. 选择添加可将权限集移入已启用列。
  3. 选择保存
在适用于 Salesforce 的 Acrobat Sign 中添加 Adobe Acrobat Sign 集成用户。

按照与您正在使用的环境对应的步骤,将用户链接到 Acrobat Sign。 

  1. 以新创建的回调用户身份登录。
  2. 导航至应用程序启动器 > Adobe Acrobat Sign 管理员
  3. 回调用户下,选择链接帐户
  4. 在"允许访问"对话框中,选择"允许"。
    \n系统将提示您重新登录 Salesforce 帐户。 
  5. 登录后,请转到 Adobe Acrobat Sign 管理员页面,并确认已链接回调用户。
在适用于 Salesforce 的 Acrobat Sign 管理员页面上链接回调帐户。

link-callback-account-2

已链接的回调帐户。

  1. 使用标准系统管理员配置文件登录适用于 Salesforce 的 Acrobat Sign 帐户。
  2. 在“适用于 Salesforce 的 Sign”Lightning 页面上,选择 Adobe Acrobat Sign 管理员选项卡。
  3. 回调用户下,选择链接帐户
  4. 在"允许访问"对话框中,选择"不是您?" 
  5. 在 Salesforce 登录页面上,输入回调用户的凭据,然后登录。

您将返回至 Adobe Acrobat Sign 管理员页面。 验证回调用户是否已链接。

为“适用于 Salesforce 的 Acrobat Sign”商业云链接回调用户。

为“适用于 Salesforce 的 Acrobat Sign”商业云链接回调用户。

登录到 Acrobat Sign 回调用户的 Salesforce 帐户。

建立回调站点

Commercial Cloud 上的 Acrobat Sign 管理员必须专门为 Adobe Acrobat Sign 回调建立和配置站点。 此设置可确保及时将协议更新推送到 Salesforce,并轻松下载大文档。 请注意,推送协议功能不适用于政府云用户。

注释

在组织中使用 Salesforce 站点之前,您必须注册 Force.com 域,用于您帐户中的所有 Salesforce 站点。 选择域名时,请保持较短的长度,以防止超过 Adobe Acrobat Sign 对回调 URL 255 个字符的限制。

使用顶部的“搜索设置”栏搜索站点,然后从搜索结果中选择站点。 或者,导航至设置 > 平台工具 > 用户界面 > 站点和域 > 站点

如果要使用已注册的站点,可以跳过此步骤。

或者,按照以下步骤注册您的站点域名:

  1. 在 https:// 后面的文本字段中输入所需的域名
  2. 选择检查可用性以确保该域可用。 在您拥有可用的域后,将会显示一条成功消息。
  3. 接受使用条款,然后选择注册我的 Force.com 域

在刷新之后的页面上,选择新建

站点编辑页面上,执行以下操作:

  1. 站点标签值设为 Adobe Acrobat Sign 回调
  2. 选择站点名称字段。 它将值自动设置为 Adobe_Acrobat_Sign_Callback
  3. 站点联系人值设为一个将接收站点相关通知的 Salesforce 用户。 在大多数情况下,该值是帐户管理员。
  4. 默认 Web 地址值设为 AdobeAcrobatSignCallback
  5. 选中活动复选框。
  6. 活动网站主页值设置为EchoSignCallback
    EchoSign 是 Adobe Acrobat Sign 的旧版名称。
  7. 选择保存
在适用于 Salesforce 的 Acrobat Sign 中创建回调站点。

在站点中添加公共访问权限设置的 IP 范围,以将其限制为 Adobe Acrobat Sign IP。 具体操作如下:

  1. 从回调站点的站点详细信息页面中,选择公共访问权限设置
  2. 选择登录 IP 范围
  3. 选择新建
  4. 在“登录 IP 范围”对话框中,输入第一个 IP 地址范围:
    • 起始 IP 地址:52.71.63.224
    • 结束 IP 地址:52.71.63.255
    • 描述:Acrobat Sign
  5. 选择保存
  6. 对于下表中的 IP 地址范围,请重复步骤 2-5。

要确定与您的区域关联的 IP 范围,请根据您使用的环境,参考以下 IP 地址列表之一: 

[重要] 在 2024 年 4 月之前,您必须添加以下新 IP 地址

核心 IP 范围 Webhook IP 范围
3.24.56.173

3.105.122.20

13.238.64.177

 

核心 IP 范围 Webhook IP 范围
4.175.107.32/28 20.61.140.48/28
3.66.122.19
4.175.108.80/28 20.61.140.128/28 3.77.229.112
4.175.110.0/28 20.61.140.144/28

3.79.169.198

4.175.111.0/28

20.61.140.224/28

4.208.68.176/28
4.208.52.80/28 20.61.140.240/28
4.208.68.208/28
4.208.52.96/28 20.61.141.0/28
4.208.68.224/28
4.208.52.112/28 51.105.155.160/28
4.208.69.64/28
4.208.52.160/28 51.105.221.164
20.50.247.192/28
4.208.53.48/28 51.145.184.32/28 20.50.247.208/28
4.208.53.64/28 51.145.186.160/28

20.54.200.16/28

4.208.53.80/28 51.145.190.176/28 20.54.201.96/28
4.208.53.96/28 51.145.190.192/28 52.215.99.205
4.208.53.112/28 52.236.2.148

54.217.241.182

4.208.53.128/28 108.141.8.0/28
54.246.37.130
4.208.53.144/28 108.141.9.0/28
 
4.208.53.160/28 108.141.9.112/28
4.208.53.176/28 108.141.9.128/28
4.208.53.192/28 108.141.9.144/28
4.208.53.208/28 108.141.9.160/28
4.208.53.224/28 108.141.9.176/28
20.56.238.208/28 108.141.9.192/28
20.56.239.128/28 108.141.9.208/28
20.56.239.96/28 108.141.9.224/28
20.61.137.144/28 108.141.9.240/28
20.61.139.192/28 108.141.10.0/28

 

核心 IP 范围 Webhook IP 范围
3.6.197.59
13.200.122.115
35.154.248.184

 

核心 IP 范围 Webhook IP 范围
35.79.243.232
52.195.144.38

52.198.1.183

 

核心 IP 范围 Webhook IP 范围
4.152.91.192/28 20.115.180.32/28 4.246.0.0/28 20.94.106.176/28
4.152.91.208/28 20.115.180.48/28 4.246.0.16/28 20.94.106.192/28
4.152.91.224/28 20.115.180.64/28 4.246.0.32/28 20.94.106.208/28
4.152.91.240/28 20.115.180.80/28 4.246.0.48/28 20.94.106.224/28
4.152.92.0/28

20.115.180.96/28

4.246.0.64/28 20.94.106.240/28
4.152.92.16/28 20.115.180.112/28 4.246.0.80/28 20.94.107.96/28
4.152.92.32/28 20.115.180.192/28 4.246.0.96/28 20.94.107.176/28
4.152.92.48/28 20.115.180.224/28 4.246.0.112/28 20.115.199.160/28
4.152.92.64/28 20.7.248.208/28 4.246.0.128/28 20.115.199.176/28
4.152.92.80/28 20.7.249.0/28

4.246.0.144/28

20.115.199.192/28
4.152.92.96/28 20.7.249.16/28 20.94.104.176/28 20.115.199.208/28
4.152.92.112/28 20.7.249.64/28 20.94.104.240/28 20.115.199.224/28
4.152.92.128/28 20.7.249.80/28 20.94.105.240/28 20.115.199.240/28
4.152.92.144/28 20.7.249.128/28 20.94.105.32/28

34.214.40.128

4.152.92.160/28 20.7.249.144/28 20.94.105.96/28 35.162.126.140
4.152.92.176/28 20.7.250.96/28 20.94.105.160/28 44.212.163.32
4.152.210.201 20.7.250.112/28 20.94.105.208/28 52.1.219.111
20.115.179.0/28
20.7.250.128/28 20.94.106.16/28 52.33.110.59
20.115.179.48/28
20.7.250.144/28 20.94.106.160/28 54.161.158.12
20.115.179.112/28
20.7.251.0/28  
20.115.179.128/28
20.7.251.16/28
20.115.179.160/28
20.7.251.32/28
20.115.179.176/28
20.7.251.96/28
20.115.179.192/28
20.7.251.112/28
20.115.179.224/28
52.236.2.148
核心 IP 范围 Webhook IP 范围
20.205.219.224/28 20.247.203.64/28 4.144.129.160/28
20.205.220.80/28 20.247.203.112/28 4.144.129.176/28
20.205.220.96/28 20.247.203.208/28 4.144.130.192/28
20.205.220.112/28 20.247.203.224/28 4.144.130.96/28
20.205.222.128/28 20.247.204.0/28 4.144.131.0/28
20.205.223.224/28 20.247.204.16/28 4.144.131.112/28
20.205.223.240/28 20.247.204.112/28 4.144.131.144/28
20.247.200.240/28 20.247.204.128/28

4.144.131.16/28

20.247.201.240/28 20.247.204.144/28 4.144.131.32/28
20.247.202.48/28 20.247.204.176/28 4.144.131.48/28
20.247.202.112/28 20.247.204.224/28 4.144.131.64/28
20.247.202.128/28 20.247.204.240/28 4.144.131.80/28
20.247.202.160/28 20.247.205.0/28 4.144.131.96/28
20.247.202.240/28

20.247.205.64/28

4.144.132.16/28
20.247.203.0/28 20.247.205.80/28 4.144.132.80/28
20.247.203.32/28 20.247.205.96/28 20.6.7.240/28
40.119.212.52  

核心 IP 范围

  • 4.246.0.144/28
  • 13.55.51.87
  • 13.55.172.219
  • 13.55.174.148 
  • 20.36.219.136
  • 20.36.220.46
  • 20.197.114.7

 

  • 20.197.115.164
  • 35.154.168.186
  • 35.154.250.71
  • 35.156.156.191
  • 35.157.18.96
  • 51.105.160.39
  • 51.105.163.48

 

  • 52.204.112.48
  • 52.205.27.150
  • 52.24.229.94
  • 52.24.62.165
  • 52.25.112.104
  • 52.184.233.100
  • 52.184.233.96/28

 

  • 52.199.157.146
  • 52.211.233.170
  • 52.213.27.89
  • 52.213.4.207
  • 54.64.99.195
  • 54.205.20.91
注释

如果您使用 Acrobat Sign 沙盒环境,则必须参考沙盒地址的 IP 范围

示例 IP 地址范围列表:

起始 IP 结束 IP 说明
13.126.23.0 13.126.23.31 Adobe Acrobat Sign
3.236.206.64 3.236.206.95 Adobe Acrobat Sign
40.67.154.249 40.67.154.249 Adobe Acrobat Sign
40.67.155.112 40.67.155.112 Adobe Acrobat Sign
40.67.155.147 40.67.155.147 Adobe Acrobat Sign
40.67.155.185 40.67.155.185 Adobe Acrobat Sign
44.234.124.128 44.234.124.159 Adobe Acrobat Sign
51.105.221.160 51.105.221.191 Adobe Acrobat Sign
52.196.191.224 52.196.191.255 Adobe Acrobat Sign
52.35.253.64 52.35.253.95 Adobe Acrobat Sign
52.48.127.160 52.48.127.191 Adobe Acrobat Sign
52.58.63.192 52.58.63.223 Adobe Acrobat Sign
52.65.255.192 52.65.255.223 Adobe Acrobat Sign
52.71.63.224 52.71.63.255 Adobe Acrobat Sign

Adobe Acrobat Sign 回调站点的最终登录 IP 范围应当如下所示:

IP 范围

注释

如果您收到"IP 范围列表不包含您当前的 IP 地址...."错误,请启用"保存此 IP 范围,即使它不包含我当前的 IP 地址"选项,然后选择"保存"。

配置单个服务

大文档可提供发送事务和背景操作的默认支持,每个文档都有它自己的大小限制,如下所示:

  • 发送事务 您可以通过"协议"页面上的"发送以供签名"选项发送单个文档或总计不超过 4.0 MB 的多个文档。
    \n
  • 背景操作 — 允许发送单个文档或多个文档,总大小不得超过 9.0 MB。 有关更多详细信息,请参阅高级自定义指南

要启用发送大文档,必须完成以下步骤:

  1. 编辑回调用户配置文件以授予额外访问权限。
  2. 启用 LargeFileDownloadService Apex 类用于站点。
  3. 更新自定义设置以使用回调 URL.

编辑回调用户配置文件

要启用 Adobe Acrobat Sign 回调站点用户的对象级别权限,请执行以下操作:

  1. 导航到“配置文件”页面,然后为您创建的回调用户(本示例中为“演示回调用户”),选择编辑
  2. 向下滚动至自定义对象权限,然后用所有协议对象权限:读取、创建、编辑、删除、查看全部、修改全部。
  3. 选择保存
配置适用于 Salesforce 的 Acrobat Sign 以发送大文档。

启用 LargeFileDownloadService Apex 类

您必须调整 Adobe Acrobat Sign 回调站点,以包括“LargeFileDownloadService”Apex 类,从而实现可见性。

以下说明与增强的配置文件界面一致。 有关配置文件界面的详细信息,请参见 Salesforce配置文件

使用顶部的“搜索设置”栏搜索站点,然后从搜索结果中选择站点。 或者,导航至设置 > 平台工具 > 用户界面 > 站点和域 > 站点

选择 Adobe Acrobat Sign 回调站点。

选择公共访问权限设置

配置适用于 Salesforce 的 Acrobat Sign 以发送大文档。

选择已启用的 Apex 类访问权限,然后选择编辑。 

配置适用于 Salesforce 的 Acrobat Sign 以发送大文档。

从左侧的可用 Apex 类列表,选择 echosign_dev1.LargeFileDownloadService,然后选择添加以将其移至启用的 Apex 类列表。 然后,选择保存

配置适用于 Salesforce 的 Acrobat Sign 以发送大文档。

配置适用于 Salesforce 的 Acrobat Sign 以发送大文档。

更新自定义设置以使用回调 URL

使用顶部的“搜索设置”栏搜索站点,然后从搜索结果中选择站点

或者,导航至设置 > 用户界面 > 站点和域 > 站点

选择 Adobe Acrobat Sign 回调

自定义 URL 部分下,选择视图

配置适用于 Salesforce 的 Acrobat Sign 以发送大文档。

从打开的新选项卡中,复制浏览器中 URL 的值并将其粘贴到文本文档中。
\nURL 应类似于:https://<my-domain>.my.salesforce-sites.com/AdobeSignCallback
\n

导航至设置 > 平台工具 > 自定义代码 > 自定义设置

对于 Adobe Sign 设置标签,请选择管理 > 编辑新建

配置适用于 Salesforce 的 Acrobat Sign 以发送大文档。

在 Adobe Acrobat Sign 设置编辑页面:

  1. 在"回调 URL Adobe 到 Salesforce 地点"字段中,粘贴您在配置 Adobe Acrobat Sign 回调地点后复制的"安全 Web 地址"的 URL。
    \n确保地址前缀为“https”而不是“http”。
  2. 选择保存

它启用大文档服务。

配置适用于 Salesforce 的 Acrobat Sign 以发送大文档。

Acrobat Sign API 允许您发送签名请求、创建 Web 窗体并将它们嵌入您的网站。 然后,在 Salesforce 中推送和创建这些协议,就像直接从其中调度一样。 您还可以通过 adobesign.com Web 应用程序发送协议,然后这些协议将同步回 Salesforce。

要启用推送协议,请执行以下操作:

注释

要使推送回调协议在 webhook 2.0 迁移后正常运行,您必须将Webhook IP 地址添加到网站回调用户配置文件。  

添加“EchoSignAgreementPushCallback”Visualforce 页面至回调站点

使用顶部的“搜索设置”栏搜索站点,然后从搜索结果中选择站点

或者,导航至设置 > 平台工具 > 用户界面 > 站点和域 > 站点

选择 Adobe Acrobat Sign 回调

配置回调站点,以将协议推送到适用于 Salesforce 的 Acrobat Sign。

向下滚动至站点 Visualforce 页面部分,然后选择编辑

启用 Visualforce 页面访问页面:

  1. 从可用的 Visualforce 页面列表中,找到并选择 echosign_dev1.EchoSignAgreementPushCallback
  2. 选择添加
    此操作会将页面移动到"已启用的 Visualforce 页面"列表。
  3. 选择保存
配置适用于 Salesforce 的 Acrobat Sign,以将文档推送回 Salesforce。

编辑站点对象和字段级别权限

添加 Visualforce 页面后,您会返回到回调站点的站点详细信息页面。 请按照以下步骤编辑页面:

  1. 选择公共访问权限设置
  2. Adobe Acrobat Sign 回调配置文件页面上,选择编辑。 
  3. 向下滚动到标准对象权限部分.
  4. 针对以下对象启用读取创建:帐户、联系人、合同、商机和机会。
  5. 选择保存
    此时将返回到回调配置文件。
  6. 要在必要时进行字段级别调整,请向下滚动至字段级别安全性部分,然后按所述编辑以下字段的设置:
    • 联系人
      • 帐户:确保选中读取访问权限和编辑访问权限复选框。
      • 电子邮件:确保选中读取访问权限和编辑访问权限复选框。
      • 名称:确保选中读取访问权限和编辑访问权限复选框。
    • 潜在客户
      • 公司:确保选中读取访问权限和编辑访问权限复选框。
      • 电子邮件:确保选中读取访问权限和编辑访问权限复选框。
      • 名称:确保选中读取访问权限和编辑访问权限复选框。

添加特定配置

要创建您帐户中所有在 Acrobat Sign 之外发送的协议并传输至 Salesforce,请执行以下步骤:

从您创建的 Acrobat Sign 回调站点复制安全 URL 地址,并在其后附加 /echosign_dev1__EchoSignAgreementPushCallback 以构成回调 URL。 

联系 Adobe 支持并向他们提供您的回调 URL,以便将其设置为您的 Adobe Acrobat Sign 帐户的默认回调 URL。
\n
\n示例: 如果您的地点地址是 https://<MyDomain>.my.salesforce-sites.com/AdobeSignCallback,您的 Acrobat Sign API URL 应该是:https://<MyDomain>.my.salesforce-sites.com/AdobeSignCallback/echosign_dev1__EchoSignAgreementPushCallback.
\n

Adobe 支持部门必须在默认回调 URL API 用户设置中输入您的 Adobe Acrobat Sign 用户 ID。 确保设置了所有 Salesforce 帐户,以将文档密钥添加到回调 URL。

如需通过 API 发送协议:

从您创建的 Adobe Sign 回调站点复制安全 URL,并在其后附加 /echosign_dev1__EchoSignAgreementPushCallback 以创建 Adobe Acrobat Sign API 的回调 URL。

示例:如果您的站点地址为 https://<MyDomain>.my.salesforce-sites.com/AdobeSignCallback,您的 Acrobat Sign API URL 则应为:https://<MyDomain>.my.salesforce-sites.com/AdobeSignCallback/echosign_dev1__EchoSignAgreementPushCallback

通过 API 发送协议或创建网页表单时,您必须提供回调 URL。
\n查看当前的"Acrobat Sign 文档 API 方法"列表并参考 API 参数"CallbackInfo"。

确保您的帐户设置已设置为将文档键附加到回调 URL,这应该是使用 Adobe Sign 的 Salesforce 客户的默认设置。
\n如有任何问题,请联系 Adobe 支持

请转到推送映射设置以定义有关在将协议推送到 Salesforce 时如何创建记录的首选项。