在表单字段中使用经过身份验证的数据

上次更新時間 2026年10月15日

使用签署方完成身份验证检查时返回的已验证身份信息填充表单字段。

已验证的表单可让 Adobe Acrobat Sign 将身份提供商返回的已核实身份信息绑定至表单字段。当签名者通过“数字身份网关”所连接的身份提供商成功完成身份验证后,Acrobat Sign 会在签署过程中将返回的身份声明中的值插入到关联字段中。

此功能专为受监管和安全敏感环境中的高信任工作流而设计,例如金融服务和政府。

身份验证数据的工作原理

身份验证数据仅通过特定字段名称约定触发。您可以将此约定用于通过以下方式创建的字段:

  • 创作界面
  • 文本标记
  • 基于 API 的工作流程

没有单独的身份验证字段类型或创作控件。

Acrobat Sign 也不会:

  • 在上传或发送文档时,验证已通过身份验证的配置。
  • 在配置不正确时显示错误。

如果字段名称不完全匹配必需的语法,该字段将表现为普通表单字段或被完全忽略。

准备事项

请确保:

  • 签名者使用通过“数字身份网关”连接的身份提供商。
  • 已为适用的帐户或组启用经身份验证的数据。
  • 您了解配置的身份提供方返回的确切身份声明名称。

声明名称由身份提供商定义,而非由 Acrobat Sign 定义。在配置字段之前,从您的身份提供方获取支持的声明名称。

有关配置数字身份提供方的信息,请参阅数字身份网关。

为经过身份验证的数据命名字段

要将表单字段绑定到经过身份验证的数据,请严格使用以下字段名称格式:

VF_DIG_{claimName}*

位置:

  • VF_ 将字段标识为已验证的表单字段。
  • DIG_ 将数字身份网关标识为身份验证方式。
  • {claimName} 是由配置的身份提供商返回的确切 OpenID Connect (OIDC) 声明名称;请确保拼写与大小写完全一致,并置于大括号内。
  • * 是用于使字段名称唯一的可选文本。

示例:

VF_DIG_{birthdate}

VF_DIG_{address}_page2

VF_DIG_{zipcode}1

如果多个字段引用同一个身份声明,每个字段仍必须具有唯一的字段名称。

Acrobat Sign 表单字段,在“自定义字段”面板中字段名称为 VF_DIG_{birthdate}。
由于身份映射在字段名称中编码,重命名字段可能会更改或删除其与身份声明的连接。

使用确切的身份声明名称

仅识别已配置身份提供商返回的身份声明。

声明名称:

  • 由身份提供方定义。
  • 区分大小写。
  • 必须完全匹配。
  • 不支持别名。
  • 如果信息不正确或缺失,系统将不予处理。

如果在身份验证期间未返回引用的声明,则该字段不会填充已验证的数据。

考虑您收集的身份数据

发件人负责确定将哪些身份属性映射到表单字段。通过配置验证表单字段,发件人可以控制将哪些身份提供商数据填充到协议中。

仅映射您的组织有权使用 Adobe Acrobat Sign 处理和存储的数据。您对数据的使用必须符合适用法律、法规、合同义务和 [Acrobat Sign 产品特定授权条款]。

请勿配置已验证表单字段来获取客户禁止在 Acrobat Sign 中收集、处理或存储的数据。例如:

  • 不得使用 Acrobat Sign 存储 PCI DSS 定义的付款卡数据或敏感身份验证数据。
  • 除非客户已与 Adobe 签订商业伙伴协议,否则不得处理受保护的健康信息。

Adobe 不会审阅、验证或限制发件人选择通过验证表单字段获取的数据。

了解签署期间的字段行为

已验证的表单字段会遵循现有的 Acrobat Sign 字段行为,并具有身份感知覆盖功能。

只读字段

当存在身份声明时:

  • Acrobat Sign 使用验证的值填充字段。
  • 签署者无法编辑该值。
  • 验证的值会覆盖任何预定义值。

如果声明缺失,则使用预定义值。

可编辑字段

当存在身份声明时:

  • Adobe Acrobat Sign 使用验证的值填充字段。
  • 字段保持可编辑状态。
  • 签署者可以更改该值。

必填字段

必填字段的行为类似于可编辑字段。

如果身份声明缺失、为空或为 null,签署者必须在完成协议之前输入值。

当已完成的协议必须保留身份提供商返回的值时,请使用只读字段。仅当工作流程允许签署者更改该值时,才使用可编辑字段。

有关字段的常规配置,请参阅表单字段属性。

在分发之前测试身份验证字段

在以下情况下,身份验证数据会静默失败:

  • 字段名称不符合所需语法。
  • 声明名称拼写错误或使用了错误的大小写。
  • 身份提供商不返回声明。
  • 对于相应的帐户或组,身份验证数据已被禁用。

协议或网页表单仍会成功发送。

在分发协议或网页表单之前,请始终在创作环境中验证字段行为。

请确认:

  • 每个字段均使用规定的命名模式。
  • 声明名称与身份提供商响应完全匹配。
  • 已验证的值填入预期字段。
  • 可编辑、只读和必填行为可实现预期的签署体验。

在“签名者身份报告”中查看验证值

当协议包含一个或多个已验证表单字段,且发件人已在帐户或组级别启用签名者身份报告,则该报告将增设专属板块,详列此类字段。

对于每个已验证的表单字段,报告包括:

  • 字段名称
  • 最终值
  • 一个状态指示器

协议完成后将确定状态。 这些内容描述最终值的来源和处理状态;不会在创作或签名阶段验证配置。

每个字段仅接收一个状态,基于以下优先级顺序:

优先级 状态 含义
1 已编辑 该字段可编辑且签名者更改了其最终值。
2 已验证 返回了匹配的身份声明,且最终值与已验证声明匹配。
3 预定义 未应用任何身份验证数据,字段保留其预定义值,且没有更高优先级状态适用。
4 声明不存在 字段引用的身份声明未由身份提供商返回。
5 空值或 Null 值 返回了身份声明但不包含可用值。

已编辑

已编辑适用于以下情况:

  • 该字段可编辑。
  • 签名者修改最终值。

已验证

已验证适用于返回匹配身份标识声明且最终值与已验证声明匹配的情况。

这包括:

  • 由已验证数据填充的只读字段。
  • 保持不变的可编辑字段。
  • 已编辑但最终包含与已验证声明相同值的字段。

预定义

预定义适用于以下情况:

  • 未应用任何身份验证数据。
  • 字段保留了作者设置的预定义值。
  • 没有更高优先级的状态适用。

声明不存在

声明不存在表示表单字段中指定的声明在身份提供商的响应中不存在。

空值或 Null 值

空值或 Null 值表示声明存在于回答中但不包含可用值。

  • 空表示空字符串或空对象。
  • Null 表示该值明确为 null。

这些状态不会生成警告或错误。报告描述已完成事务的结果,而非配置错误。

签名者身份报告列出了已验证的表单字段及其最终值和身份验证状态。
该状态帮助审阅者区分从已验证身份数据保留的值与已编辑、预定义、不可用或返回时不包含可用内容的值。

需要了解的事项

  • 已验证表单使用普通的 Acrobat Sign 表单字段;不存在专门的身份验证字段类型。
  • 身份验证行为由必需的字段名称约定触发。
  • 命名约定适用于创作界面、文本标记和 API 创建的字段。
  • 声明名称区分大小写,必须与身份提供商响应完全匹配。
  • 配置不正确可能会静默失败,而不会阻止发送协议或网页表单。
  • 可编辑的已验证字段无法保证最终值仍与身份提供商返回的值保持一致。
  • 在分发协议或网页表单之前,请务必测试身份验证字段的运行效果。
  • 启用报告时,签署者身份报告会为每个已验证的表单字段分配一个最终状态。