问题键
\n
Adobe Sign 发行说明:2021
Adobe Sign:2021 年 3 月
改进的功能
Adobe Sign 移动查看中的"液态模式"
Liquid Mode 是一项用来生成响应式视图的可选功能,凭借这项功能,您可以根据签名者的设备类型来改进文档的显示效果。
已签署的文档以标准"PDF"版本存储,而收件人可以在手机上查看 液态模式,并可切换查看原始文档。
您现在可以上传 HTML 文档并为手机生成 Liquid Mode 视图。
通过图像或手绘签名方法签署时锁定已知用户的 姓名 值
在某些情况下,签名仪式期间无法更改接收者的姓名。 Adobe Sign 在这方面提供了灵活性,可尊重签名者的姓名偏好。 更加正规的场合是不能接受这种灵活性的,为此,Adobe Sign 提供了一项可锁定协议接收者姓名的新控件。
管理员现在能够防止具有已知 姓名 值的收件人在应用 手绘 或 图像 签名时更改这些值。
姓名值已知的情况:
增强电子邮件安全的选项
有两个新选项可用来提高电子邮件安全性。 这两个选项的设置默认情况下均处于启用状态:
- 在电子邮件中包含链接以查看已签署的协议
- 在电子邮件中包含协议首页的图像
- 默认处于启用状态
- 启用后,协议首页的图像会在某些电子邮件分发中显示
v6 REST API 更新
每个 V6 REST API 请求中的标准标头
默认情况下,每个 v6 REST API 请求现在都具有以下标准标头:
/AGREEMENTS
所有具有协议 ID 路径的/agreements 端点现在都会返回 404 AGREEMENT_DESTROYED 错误代码,如果协议已通过 GDPR 工具删除。
库模板
PUT /libraryDocuments/{libraryDocumentId} 展开以包含新字段 ownerId
只有 v6 REST API 受影响。
任何不包含这些页眉的 v6 REST API 调用都会明确记录该缺失。
- GET /libraryDocuments 展开以包含新字段 ownerEmail
- GET /libraryDocuments/{libraryDocumentId} 展开以包含新字段:ownerId、ownerEmail 和 ownerName
LibraryDocumentInfo 对象中的新字段:
具有更新行为的字段:
- PUT /widgets - 现在支持使用有效的 libraryDocumentId 创建网页表单
已添加的状态代码:
- PUT /widgets/{widgetId} - 已扩展以包含新字段 ownerId
已添加的状态代码:
体验更改
具有已更改行为的字段:
参数:
回答对象:
- PUT /megaSigns/{megaSignId}/formFields - 更新 Mega Sign 协议的表单字段
参数:
响应对象:
- PUT /megaSigns/{megaSignId}/state - AUTHORING 已添加为状态值,以支持创作 Mega Sign 模板。因此,megaSignCancellationInfo 不再是必填字段
余下所有帐户均已启用新版“主页”和“管理”页面
所有帐户的控件设置均已更新,为其用户启用现代主页和管理页面。
管理菜单中的控件对于必须恢复到经典体验的帐户仍然可用:
Adobe Sign 服务水平和帐户 ID 在管理菜单中公开
管理员现在可以在全局设置页面上找到他们的帐户 ID:
可在"组设置"页面上找到"组 ID ":
显式 HIPAA 配置
增添了一个新的页面,可清晰地展示启用帐户的时间,以管理符合 HIPAA 要求的协议。
- 这个控件仅在帐户级别显示。 组级别管理员无权访问
- 此控件为只读,用于明确指示帐户的配置状态
- 请联系您的成功经理或支持团队,以便启用 HIPAA 配置
对于在 Windows 系统上使用 Outlook 桌面应用程序的客户,"行动号召"按钮已更改
对于使用 Outlook 桌面电子邮件客户端的收件人来说,他们将会在 Adobe Sign 电子邮件中注意到“调用操作”按钮发生变化。
新体验移除了蓝色 HTML 按钮,改为提供可点击的文本链接:
此更改仅影响 Windows 系统上的 Outlook 桌面应用程序。其他电子邮件客户端和操作系统会继续收到带蓝色按钮的模板。
数据治理的最大值已增加到 5475 天(15 年)
使用数据治理规则从 Adobe Sign 系统中自动删除协议的客户现在可以将该删除日期设置为最多 15 年(从 10 年提升)。
用于验证美国社会保险号的字段级文本标签已更新:
用于验证美国社会保险号的字段级文本标签已更新,以表明 SSN 仅适用于美国:
提醒:社交身份验证已移除
如十一月发布的公告中所述,使用社交身份标识的身份验证方法已从 Admin 菜单中的身份验证方法列表中移除。
提醒:个人 Twitter 集成已移除
正如 12 月份宣布的那样,已删除用户与 Twitter 进行个人身份验证连接的功能。
处于非活动状态的用户在被纳入协议时将收到电子邮件通知
设置为非活动状态的用户现在会收到电子邮件通知,通知其将协议委派给其他用户。
已解决的问题
Adobe Sign:2021 年 5 月
改进的功能
将库模板和 Web 表单的所有权转让给其他用户
帐户中任何有权访问资源的管理员现在都可以更改资源所有者。
管理员可以将资产所有权分配给其权限范围内的任何用户。
- 帐户管理员有权访问所有共享资源和所有用户。 因此,帐户级别管理员可以将任意库模板或 Web 表单的所有权重新分配给其帐户中的任何其他用户
- 如果将资源配置为仅对一个用户(当前所有者)可用,则无法共享此资源,因此也无法重新分配给新所有者
- 组管理员只能访问其拥有管理权限的组内的库模板和 Web 表单
- 群组管理员只能将资产重新分配给主要群组隶属于其管理权限范围内的用户
支持资产转移的更新 API 端点
下面所述的端点仅在 v6 REST API 中可用。
经过扩展后,支持更新库文档所有者。
LibraryDocumentInfo:
其他错误状态代码:
其他错误状态代码:
LibraryDocument 对象中的新字段:
LibraryDocumentInfo 对象中的新字段:
行为更新的字段:
WidgetInfo 对象中的新字段:
行为更新的字段:
体验更改
默认 v6 REST GET /workflows{workflowId} 返回值已更改
v6 REST GET /workflows{workflowId} API 调用已更新,现在返回 WorkflowID 的当前版本(而不是原始版本 ID,那是 5 月版本发布前的返回值)
此更新将默认 API 体验与 Webhook 体验保持一致,提供相同的 WorkflowID,这应该能够改善应用程序的开发和管理。
如果由于任何原因,您的帐户需要 API 返回原始 ID(如 5 月版本发布前的情况),请联系支持人员申请让您的帐户返回工作流的基础版本 ID
已解决的问题
Adobe Sign:2021 年 6 月
想要升级的现有企业和商业帐户可以在此处查看升级过程 >
在 Sign 中引入 Liquid Mode
对于手机,为通过“发送页面”或 sendAgreement API 发送的 HTML 启用 Liquid Mode 视图。 现在,用于为 HTML 启用 Sign 中的 Liquid Mode 的选项在帐户和组级别的“管理员”菜单列表中均可使用。
有关 Liquid Mode 文档的完整详细信息,请参阅此处 >
Liquid Mode 当前仅在 NA1、NA2 和 NA4 环境中可用。
要启用无缝 Web 表单功能,必须在全局设置菜单中启用允许更多参与者选项:
OAuth 2.0 是新的默认值
为了避免出现使用错误,已增加新(改进)版本的 OAuth 端点。 使用这个版本时:
- 仅在访问令牌请求(正文)中返回 api_access_point / web_access_point
- Adobe Sign 不接受作为查询参数的密钥
- 支持客户端密钥轮换
\n
为了确保能够持续访问,OAuth v1 端点将在接下来的几个月继续用于现有连接。
OAuth v1 的弃用将在计划时在技术通知页面上公布。
\n
客户端密钥轮换
任何有权在 Adobe Sign UI 中访问应用程序 ID 的管理员都可以轮换应用程序客户端密钥:
体验更改
更新了 GET /agreements/{agreementId}/signingUrls 的 v6 REST API 结果
在 6 月版本发布之前,当调用 GET /agreements/{agreementId}/signingUrls 时,API 将在协议创建后立即返回 404。
在清除 404 错误后的很短时间内,响应将返回非 404 响应,但只包括发件人的 signingURL。 (不过仍会定义签名者的参与。)
在 2021 年 6 月版本发布后,将返回 404: AGREEMENT_NOT_EXPOSED 代码,直到完整的签名 URL 列表完成,此时将发送 200 代码。
如果客户在返回 200 响应之前不想继续尝试该 API 调用,建议使用 Webhook 并回复 AGREEMENT_CREATED 事件。
已解决的问题
Adobe Sign:2021 年 8 月
体验变化
- Aadhaar 国际化支持 – 现在,所有 Adobe Sign 实例的客户都能将可选的 Aadhaar 服务用作数字签名提供程序。 这项服务以往只适用于 IN1 实例上的帐户。 可按照每项签名交易,以额外的费用购买 Aadhaar 加载项。
- REST v6 更新:POST /users - 更新了 REST v6 POST /users API 调用,在未定义可选的 primaryGroupId 参数时,可创建帐户 Default 组的用户。 这项变化只影响 REST v6 API。
已解决的问题
|
|
描述 |
|---|---|
|
4299495 |
修复了工作流程设计器中的一个问题,该问题会导致说明中客户定义的 URL 无法正常工作。 |
|
4308294 |
修复了报告 CSV 文件中的一个问题,当在协议中多次使用同一收件人电子邮件时,"收件人"和"收件人姓名"字段可能会保留为空。 |
|
4310569 |
Adobe Sign 模板已从沙盒选项中筛选出。 |
|
4311098 |
修复了组管理员无法通过 CSV 上传更新组中用户的问题。 |
|
4311723 |
修复了当用户位于不同 Adobe Sign 安装实例上时,GET /groups/ID/users API 调用会失败的问题。 |
|
4312103 |
修复了通过批量上传创建的 SAML 用户处于"已创建"状态(而非"主要"状态)的问题。 |
|
4312309 |
修复了组管理员无法重新分配由其组中其他用户创建的网页表单的所有权的问题。 |
|
4312840 |
修复了一个问题,即当向新用户发送第二封激活电子邮件并使用第二封电子邮件链接时,激活新用户时出现问题。 |
|
4314751 |
修复了代表其他用户签署时拒绝协议的选项不可见的问题。 |
|
4315033 |
修复了一个问题,即当 SAML 模式设置为强制时,帐户管理员无法重置密码。 |
|
4315605 |
修复了政府身份证件图像无法成功处理的问题。 |
|
4316057 |
修复了一个问题,即身份证会产生错误,指示找不到文档的四个角。 |
|
4316474 |
修复了在未启用该选项的帐户中显示"代签"的问题。 |
|
4316659 |
修复了 GET /agreements/id 调用中“actingUserEmail”的电子邮件地址在协议完全签名后返回一封系统生成的电子邮件的问题。 |
|
4317095 |
修复了当第一个签署者使用基于知识的身份验证时,收件人姓名会被导入参与者 1 标签的问题。 |
|
4317221 |
修复了尽管配置为不通知创建者,但 Webhook 失败的自动通知电子邮件仍会发送给 Webhook 创建者的问题。 |
|
4317347 |
修复了一个问题,该问题会导致 Power Automate 中的 OAuth 身份验证将用户重定向到主页。 |
|
4317429 |
修复了一个问题,即管理员在通过 CSV 上传更新时无法为用户更新 Can Send 属性。 |
|
4317548 |
修复了一个问题,即部分使用 iPad 的客户会看到网页而不是为移动设备优化的页面。 |
|
4317629 |
修复了包含撇号的姓名显示撇号 HTML 代码的显示问题。 |
|
4318175 |
更正了用户通过电子邮件链接存档帐户时出现错误的问题。 |
|
4319012 |
修复了通过 REST v5 和 v6 POST /users 创建的用户不在默认组的问题。 |
|
4320197 |
修复了一个问题,即由于按钮处于非活动状态,无法从管理页面下载签署者身份报告。 |
Adobe Sign:2021 年 9 月
改进的功能
- 沙箱 - 企业级客户可选择购买沙箱环境的访问权限,以测试模板、客户工作流程、API 应用程序等。 为了在安全环境中执行更新,可将这些对象从生产环境移至沙箱;当核实了更新内容并准备部署时,可将这些对象再移回生产环境。
- ECDSA 数字签名支持 - Adobe Sign 现在支持基于 ECDSA 格式的更安全、更高效的数字签名,该格式使用 ANS X9.62-2005 标准中定义的椭圆曲线加密技术。
\n现在,由 FIPS 标准定义且具有 SHA-2 哈希函数的 NIST 曲线受到支持。这让来自云签名联盟的受信任的服务提供商 (TSP) 合作伙伴有权选择为签名者提供更快、更安全的椭圆曲线凭据,其中包括满足美国联邦和新加坡政府使用的建议要求的凭据。
- Liquid Mode 已更新 - Liquid Mode 签名体验对协议进行了扩展以包括 Web 表单。 Liquid Mode 表单减少了查看表单内容时的缩放操作,同时提高了对需要填充的字段中的焦点,从而可以显著改善签名者的体验。
\n
- 新增 TSP - Cleverbase(荷兰)、PrimeSign(奥地利)、Sectigo(全球)和 TrustPro(爱尔兰)是云签名联盟中新加盟的受信任服务提供商,该联盟向其服务提供商授予了应用满足最高标准及合规性要求的安全数字签名的认证。
- 自定义收件人电子邮件页眉中的收件人和抄送字段 - 担心通过电子邮件页眉向收件人泄露电子邮件地址的客户可以选择在收件人和抄送字段中隐藏电子邮件地址值。
\n- 此选项适用于企业帐户和业务层帐户,可在帐户和组级别进行配置。
- 可以通过导航到帐户设置 > 电子邮件设置 > 自定义收件人和抄送字段来访问功能控件。
\n
体验更改
- 接受电子签名页面上的 Adobe 使用条款 - 为了遵守 Adobe 法律要求,Adobe Sign 即将更新电子签名页面上的使用条款 (TOU) 接受行为。 在新的体验中,所有“未知”收件人都必须先接受 Adobe Sign ToU 和隐私政策(通过单击继续按钮),然后才能与相关协议进行交互。 这种接受行为与客户帐户可能配置的任何自定义 ToU 截然不同,后者将根据帐户 TOU/CD 接受配置继续解析。
- "未知"收件人是指任何不是受信任帐户中已注册的主要用户电子邮件的电子邮件地址。
\n - “已知”用户在验证其用户帐户时,已于注册过程接受了 Adobe Sign ToU,因此系统不会提示他们再次接受 ToU。
以下示例演示了包含客户配置的自定义 ToU 的协议的默许流程:
- 通过选择继续按钮(打开协议后),接受 Adobe Sign 使用条款。
- 根据需要填写协议字段。
- 通过选择单击签署按钮来接受客户披露和自定义使用条款。
\n
- 锁定扩展为“已键入的签名”的名称值 - 3 月版引入了一项设置,可用来启用/禁用收件人在签名时编辑其名称值的功能,使用这项设置的前提条件是过去已提供或已知晓该名称(通过 API 或用户配置文件)。 这项功能可将已键入的签名排除在外,从而允许一些签名者在签名过程中更改其名称值。 9 月版将更新该功能,以支持所有签名类型(包括“已键入的签名”)的名称锁定设置。
- 已启用键入其姓名和姓名首字母并禁用签署者可以更改其姓名或姓名首字母的客户将看到行为变化 - 在键入签名的签名过程中,姓名值不再可编辑。
\n - 如果客户想要在签名过程中允许编辑名称值,则应当启用签名者可以更改其姓名或缩写签名设置(位于签名首选项菜单中)。
- “非活动”用户可以签署协议 - Adobe Sign 现在将“非活动”用户视为系统未知用户(用于签署入站协议)。 当要求“非活动”用户签署协议时,系统将明确创建一个仅供单次使用的新用户 ID,以用于签署协议。 这个仅供单次使用的用户 ID 独立于“非活动”的用户 ID 以及掌控该 ID 的帐户。 这种方式将会产生以下结果:
- 可以签署发送给“非活动”用户的协议,因为这个“非活动”状态不适用于为协议生成的且仅供单次使用的用户 ID。
- 由仅供单次使用的用户 ID 签署的协议不属于“非活动”用户 ID 的资源,并且不会驻留在“非活动”用户 ID 的帐户中。
- 在“非活动”用户 ID 共享的内容中,将不会体现由仅供单次使用的用户 ID 签署的协议。
- 针对“非活动”用户 ID 的报告,将不会反映由仅供单次使用的用户 ID 签署的协议。
- 如果重新激活了“非活动”用户 ID,这些用户 ID 将不会在其“管理”页面上看到由仅供单次使用的用户 ID 签署的协议记录。
上述行为有两种例外情况:
- 有可能无法签名那些在用户被标记为“非活动”之前发送给他们的协议(协议已绑定到“非活动用户 ID”)。
- 明确配置为不允许签署协议的用户将继续被禁止执行任何签署操作。
\n
仍将阻止“非活动”用户登录 Adobe Sign 系统,并且会在其授权下(通过任何方法)发送协议。
- 通过密码提高了访问 Web 表单的安全性 - 对于在访问受密码保护的 URL 时经历多次失败尝试的情况,Web 表单会将此计入延迟的一部分。
- Aadhaar 国际化支持 – 现在,所有 Adobe Sign 实例的客户都能将可选的 Aadhaar 服务用作数字签名提供程序。 这项服务以往只适用于 IN1 实例上的帐户。 可按照每项签名交易,以额外的费用购买 Aadhaar 加载项。
- 协议共享限制 - 向外部电子邮件地址共享协议时,协议共享已受到限制。
\n- 多许可证帐户最多可将任一协议共享 10 次。
- 个体帐户最多可以共享协议 5 次。
\n - 与内部用户共享协议时不受限制。
- 多许可证帐户最多可将任一协议共享 10 次。
- 已从服务中移除电话身份验证中自定义的公司名称 - 根据 6 月份技术通知宣布的内容,已经移除原来插入在电话身份验证方法中的可自定义的公司名称值。
- 现在,支持 HIPAA 的帐户可以在“全局/组设置”页面上,访问适用于收件人电子邮件中图像和链接的控件。
- 最终 PDF 中包含文件附件的顺序已更新为首先按页码排序,然后按字段位置排序(从左到右;从上到下阅读时)
\n
- 现在,新“管理”页面上的替换收件人功能允许发件人向新的收件人发送可选消息。
- 为协议配置了多重身份验证(而并非提示登录 Adobe Sign),这样一来,外部签名者现在必须通过身份验证流程,才能访问已完成的协议。
- 现在,使用“管理”页面上的“下载表单字段数据”功能访问字段数据时,可报告未经验证的 Web 表单的字段值。
API 更新
- Web 表单的“阅读协议”选项 - 两个新增的 REST v6 API 调用可提供查看 Web 表单的访问权限:
- GET /widgets/<resourceId>
- GET /widgets/<resourceId>/combinedDocument/url
- 现在,GET/workflows/{workflowId} 会在响应中返回参与者角色。
已解决的问题
| 4292343 | 提升了在移动设备上使用 TYPE 签名选项时的签名清晰度。 |
| 4295123 | 修复了在浏览器中打开数字签名时可能看不到数字签名的问题。 |
| 4299289 | 改善了“替换收件人”体验,即允许发件人包括一则发给新收件人的消息。 |
| 4299857 | 修复了可能导致已签名的协议未应用认证封印的问题。 |
| 4304261 | 修复了导致“选项”菜单中无法填充“读取协议”选项的问题 |
| 4308516 | 修复了在使用 OneDrive 时,系统持续提示用户获得管理员同意的问题 |
| 4310225 | 修复了包含多个签名的协议可能触发服务器错误的问题:错误消息:应用于此文档的签名无效。请清除该签名并重新签署。 |
| 4310416 | 更新了 v5 REST API,现在可以在使用 POST /users 创建用户时,创建处于活动状态的用户 |
| 4311287 | 修复了在从某个组删除用户后,“组”导航按钮从启用 UMG 的帐户上消失的问题。 |
| 4311956 | 修复了字段的指定字体大小未反映在签名者体验中的问题。 |
| 4312302 | 修复了在将 SAML 模式设置为“强制”时,系统会删除“重置密码”选项的问题。 |
| 4312735 | 修复了在禁用共享通知时导致发送共享事件通知的问题。 |
| 4313025 | 修复了启用混合路由时,表单填写人角色无法填写未分配角色的问题。 |
| 4313030 | 修复了在不允许发送有关发件人的主组时,启用 UMG 的帐户由于使用自定义工作流而触发错误的问题。 |
| 4313264 | 更新了启用 HIPAA 的设置,允许在“全局设置”页面上访问电子邮件链接/图像设置。 |
| 4315839 | 更正了当发件人同时也是从属收件人的情况下,不允许预填字段的自定义工作流问题。 |
| 4316058 | 更新了报表字段行为,允许在文本字段中显示前导零。 |
| 4317382 | 更正了工具提示中显示撇号 HTML 代码的单选按钮存在的问题 |
| 4317978 | 更新了文件附件在最终 PDF 中的排序方式,即先按字段页码,再按字段相对位置来分组附件(从左到右、从上到下读取时)。 |
| 4318598 | 现在,GET/workflows/{workflowId} REST v6 API 调用会在响应中返回参与者角色。 |
| 4318606 | 现在,“管理”页面上的“下载表单字段数据”功能可返回尚未经过验证的 Web 表单的字段值。 |
| 4318617 | 修复了启用 UMG 的帐户不允许组管理员重新发送邀请的问题。 |
| 4318679 | 修复了可能导致书面签名文档无法上传的间歇性问题。 |
| 4318926 | 更正了在移动设备上生成协议时可能触发错误(您的浏览器上禁用了 Cookie 功能)的问题。 |
| 4318991 | 修复了在将 SAML 模式设置为“允许”时,可能导致忽略最大登录失败设置的问题。 |
| 4319068 | 现在 如果配置了多重身份验证,则外部收件人需要通过双重身份验证流程(而不是登录 Adobe Sign),才能访问已完成的协议。 |
| 4319422 | 修复了在不确认密码的情况下替换收件人的问题(针对密码验证的协议) |
| 4319455 | 修复了在高级共享功能中,经过存储后的设置可能无法持久的问题。 |
| 4320123 | 修复了尝试在“管理”页面上查看和批准协议时可能触发错误的问题。 |
| 4320205 | 修复了在使用高级共享功能预填协议时,可能无法保存进度的问题。 |
| 4320542 | 修复了启用 UMG 的帐户存在的问题,即如果使用“搜索”功能移除了某个组,则可能会删除用户的所有组从属关系。 |
| 4321357 | 修复了在选择 KBA 进行身份验证并启用“发送时需要名称”的情况下,可能会在发送页面上触发错误的问题。 |
| 4322445 | 改进了编辑功能,确保背景色保持一致。 |
| 4322956 | 修复了在自定义的电子邮件模板中,收件人看不到签名者实际电子邮件地址的问题。 |
| 4323609 | 在开发阶段 - 修复了在那些通过上传已签名文档而完成的协议中,不触发 AGREEMENT_WORKFLOW_COMPLETED Webhook 通知的问题。 |
| 4323968 | 改进了签名锁定功能,可在通过配置文件或 API 提供名称值时包括“已键入的签名”。 |
Adobe Sign:2021 年 10 月
改进的功能
- 举报滥用链接 - 现在,小型企业帐户和个人帐户包含一个链接,收件人可通过此链接访问一种方法,以报告有关入站协议请求的潜在滥用活动。
- 与 Notarize 集成 - Adobe Sign 与 Notarize, Inc. 的远程在线公证 (RON) 平台的集成,使得客户得以在 Adobe Sign 交易中添加远程在线公证服务。 对于直接由 Adobe 通过 ETLA 计划销售产品的企业级和商务级美国客户而言,可启用这项服务。 这些客户只能将 Notarize 交易作为加载项,通过额外支付费用来购买。
- 发送页面更新 - 启用公证的客户可以在收件人记录上选择要求公证选项,此选项就位于身份验证方法的右侧:
- 发送页面更新 - 启用公证的客户可以在收件人记录上选择要求公证选项,此选项就位于身份验证方法的右侧:
在应用程序或集成中使用嵌入的发送页面的客户也可以访问公证功能。
在配置协议并且发送者单击“下一步”后,发送者将收到公证流程的其他配置选项:
- API 更新 - 对 API 进行了重要更新,以支持 Notarize 集成:
POST /agreements
POST /agreements API 已更新为支持发送公证协议。
- 新角色 NOTARY_SIGNER 应该用于指示公证会话参与者。
- 新的 NotaryInfo 属性已添加到 AgreementInfo 定义,以包含与创建需要公证的新协议相关的所有选项。
|
参数名称 |
REST 对象 |
说明 |
||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
memberInfos |
ParticipantInfo[] |
ParticipantInfo 对象的数组,包含特定于参与者的数据(如电子邮件)。 数组中的所有参与者都属于相同集。 |
||||||||||||||||
|
role |
|
该集内所有参与者(签名者、审批人等)承担的角色 |
FileInfo 扩展
需要扩展 FileInfo 定义,以指明哪些文档应经过公证。
|
参数名称 |
类型 |
默认设置 |
必需 |
说明 |
|---|---|---|---|---|
|
document |
文档 |
|
可选 |
与协议关联的文档。 |
|
label |
字符串 |
|
可选 |
文件信息元素的唯一标签值。 对于自定义工作流,这会将文件映射到工作流定义中的相应文件元素。 |
|
libraryDocumentId |
字符串 |
|
可选 |
将添加到协议中的现有库文档的 ID |
|
transientDocumentId |
字符串 |
|
可选 |
将添加到协议的临时文档的 ID |
|
notarize |
true |
false |
可选 |
表示此文档需要经过公证。 |
ParticipantInfo 扩展
ParticipantInfo 定义已扩展为允许指定公证人身份验证方法。
|
参数名称 |
类型 |
默认设置 |
必需 |
说明 |
|---|---|---|---|---|
|
|
字符串 |
不适用 |
必需 |
参与者的电子邮件。 |
|
notaryAuthentication |
枚举 |
MULTI_FACTOR_AUTHENTICATION |
可选 |
MULTI_FACTOR_AUTHENTICATION - 公证人身份验证使用双重身份验证方法执行 |
NotaryInfo
新的可选 notaryInfo 字段已添加到 AgreementInfo 定义,以包含 NotaryInfo 对象,它指定与公证关联的其他选项。
|
参数名称 |
类型 |
默认设置 |
必需 |
说明 |
|---|---|---|---|---|
|
notaryType |
枚举 |
如果帐户上仅启用了 Notarize 按需公证服务, |
必需 |
NOTARIZE_NOTARY - Notarize 服务提供公证人 |
|
payment |
枚举 |
BY_SENDER |
可选 |
仅当类型 == NOTARIZE_NOTARY 时才适用 |
|
appointmentStart |
字符串 |
"" |
可选 |
ISO_DATE_TIME 格式的字符串 请参阅 ISO_ZONED_DATE_TIME |
|
note |
字符串 |
无 |
可选 |
公证会的说明。 |
|
notaryEmail |
字符串 |
"" |
可选 |
自带公证的电子邮件 |
示例 /agreement
PUT|GET /agreements/{aid}
PUT /agreements/{aid} API 将支持使用公证选项更新协议。 GET /agreements/{aid} API 将返回为协议公证设置的所有选项。 请参阅“POST /agreements”部分以查看更新的属性。
错误代码
POST /agreements 的现有错误代码保持不变。 我们定义了新的错误代码,如下所示:
|
REST 错误代码 |
HTTP 状态代码 |
消息 |
情景 |
|---|---|---|---|
|
PERMISSION_DENIED |
403 |
用户设置或 OAuth 范围令牌不允许发送协议进行公证。 |
当角色设置为 NOTARY_SIGNER 且 API 调用者(即潜在发送者)未启用公证功能和/或未设置公证服务提供者时,将引发此错误。 |
文档影响
在请求的 AgreementInfo 对象中,“status”元素将包含新协议状态“WAITING_FOR_NOTARIZATION”。
POST /agreements/{agreementId}/members/participantSets/{participantSetId}/participants/{participantId}/signingTokens
客户(公证签名者)可以使用该 API 来获取签名令牌,以便可以完成流程的电子签名阶段。
- 添加了新签名功能以捕获新角色 - ACCEPT_BEFORE_NOTARIZATION。
- 不应获取签名令牌来完成公证阶段。
PUT /agreements/{agreementId}/members/participantSets/{participantSetId}/participants/{participantId}/status
客户(公证签名者)可以使用该 API 完成流程的电子签名阶段。 为了照顾到新角色,引入了新枚举状态值 - ACCEPTED_BEFORE_NOTARIZATION。
|
属性 |
类型 |
说明 |
||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Status |
Enum<String>
|
|
||||||||||||||
公证签名者可以按照以下 API 调用序列完成电子签名阶段:
- GET /agreements/{agreementId}/members - 获取公证签名者的参与者 ID 和参与者集 ID
- POST /agreements/{agreementId}/members/participantSets/{participantSetId}/participants/{participantId}/signingTokens - 为具有 ACCEPT_BEFORE_NOTARIZATION 功能的公证签名者请求签名令牌
- POST /transientDocuments - 上传已审阅的文档
- PUT /agreements/{agreementId}/members/participantSets/{participantSetId}/participants/{participantId}/status - 提交已审阅的文档并完成电子签名阶段。
新的 Webhook 事件
客户可以订阅新的 WebHook 事件 AGREEMENT_READY_FOR_NOTARIZATION,在协议准备好进行公证时获得通知。 该事件在 webhooks UI 上不可见,可通过 POST /webhooks API 调用进行订阅。
文档影响
以下 API 未进行修改,但其文档已更新为包括新协议状态“WAITING_FOR_NOTARIZATION”或新角色“NOTARY_SIGNER”。
GET /agreements
在响应 UserAgreements/UserAgreement 对象中,“status”元素现在包含状态“WAITING_FOR_NOTARIZATION”。
GET /agreements/{agreementId}
在响应 AgreementInfo 对象中,“status”元素现在包含对应状态“WAITING_FOR_NOTARIZATION”。
GET /agreements/{agreementId}/events
更新了 API 以支持新的 READY_TO_NOTARIZE 和 NOTARIZED 事件。
在响应 Event 对象中
- “participantRole”元素现在包括新角色 NOTARY_SIGNER。
- “type”元素包括新事件 READY_TO_NOTARIZE 和 NOTARIZED。 “description”元素分别为“Document sent for notarization”(文档已发送进行公证)和“Notarized document received”(已收到公证的文档)
GET /agreements/{agreementId}/members/participantSets/{participantSetId}
在响应 DetailedParticipantSetInfo 对象中,“status”元素现在包含对应状态“WAITING_FOR_NOTARIZATION”。
PUT /agreements/{agreementId}
请求 AgreementInfo 对象现在包含“WAITING_FOR_NOTARIZATION”状态。
PUT /agreements/{agreementId}/members/participantSets/{participantSetId}
WAITING_FOR_NOTARIZATION 状态是 DetailedParticipantSetInfo 对象中的“status”元素值之一。
POST /agreements/{agreementId}/view
WAITING_FOR_NOTARIZATION 状态已添加为一种允许的视图。
GET /agreements/{agreementId}/members/participantSets/{participantSetId}/participants/{participantId}/signingInfo
如果在请求路径中指定的参与者具有公证签名者角色,这个 API 将返回 ACCEPT_BEFORE_NOTARIZATION 签名配置,以便与这个协议/参与者的所有其他签名配置保持一致。
已解决的问题
| 问题 | 说明 |
| 4308901 | 更正了委派协议时,如果委派的电话号码具有相同的国家/地区代码,则通过电话身份验证委派协议会引发错误的问题。 |
| 4314113 | 修复了用户在发送新协议时无法编辑默认到期日期的问题 |
| 4318558 | 更正了将收件人替换为电话身份验证时提示“指定的参与者集 ID 无效”错误的问题 |
| 4319038 | 修复了发件人在使用“批量发送”工作流程发送时未显示“外部收件人身份验证”选项的问题。 |
| 4319798 | 修复了选择单选按钮时可能导致光标焦点跳转到其他字段的问题。 |
| 4320154 | 修复了可能阻止库模板保存到新组关系的问题。 |
| 4323013 | 修复了在管理页面上打开 Web 表单时会触发错误“文档尚不可用或将没有可查看的页面”的问题。 |
| 4323554 | 修复了更新管理员权限的事件时间/日期戳可能生成两条具有相同时间值的记录的问题。 |
| 4323609 | 修复了在管理页面中上传已签名协议时不会触发 AGREEMENT_WORKFLOW_COMPLETED Webhook 的问题。 |
| 4325142 | 修复了取消协议后自定义电子邮件模板不会反映参与者的正确姓名值的问题。 |
| 4326747 | 修复了可能导致“批量发送”页面无法完成加载过程,且忽略“上载”和“发送”操作的问题。 |
| 4326855 | 修复了可能阻止收件人拒绝批准协议的问题。 |
| 4327000 | 更正了可能导致 Smart-Id 凭据失败,并显示未找到算法的错误的问题。 |