如何在PDF中附加Wacom STU SDK的手写生物特征数据（Java）

一、标准格式选择 #

• PAdES/CAdES 签名标准：这是电子签名合规领域的通用标准，支持将签名的生物特征元数据（压力、时序、坐标序列等）作为签名扩展属性嵌入。Wacom的PenData可序列化为JSON/XML等结构化格式，作为签名属性附加到PAdES签名中，完全满足合规要求——这类格式本身就是为电子签名的完整性、可追溯性设计的，能确保生物数据与签名绑定不可篡改。
• PDF自定义嵌入式附件：若无需严格遵循签名标准，也可将序列化后的PenData作为PDF的嵌入式文件附件存储，同时在签名区域关联附件引用。但这种方式的合规性需结合具体监管要求确认，优先推荐PAdES方案。

二、基于iTextPDF的实现步骤 #

1. 序列化PenData：将Wacom SDK获取的压力、时序、坐标等点数据序列化为结构化字符串（以JSON为例，用Jackson工具）：

   // 示例：把PenData集合转为JSON字符串
   ObjectMapper mapper = new ObjectMapper();
   String penDataJson = mapper.writeValueAsString(penPointList);
   

2. 创建PAdES签名并附加元数据：
   使用PdfSigner构建签名，通过SignatureProperties添加自定义签名属性，将PenData嵌入签名扩展字段：

   PdfSigner signer = new PdfSigner(reader, outputStream, new StampingProperties());
   // 配置签名基础参数（证书、签名算法等，此处省略）
   SignatureProperties props = new SignatureProperties();
   // 添加自定义属性，可使用合规的OID或自定义名称
   props.addSignatureAttribute(new PdfName("WacomBiometricData"), new PdfString(penDataJson));
   // 生成CAdES/PAdES签名
   signer.signDetached(externalSignature, certChain, null, null, null, 0, PdfSigner.CryptoStandard.CADES);
   

3. 嵌入签名图片：在签名外观设置中，将手写签名的图片绑定到签名区域，确保生物数据与可视化签名关联。

三、基于Apache PDFBox的实现步骤 #

1. 序列化PenData：同iText方案，先将PenData转为JSON/XML字节数组。
2. 创建PDF签名并添加元数据：
   通过PDSignature构建签名，在签名字典中添加自定义条目存储PenData：

   PDSignature signature = new PDSignature();
   signature.setFilter(PDSignature.FILTER_ADOBE_PPKLITE);
   signature.setSubFilter(PDSignature.SUBFILTER_ADBE_PKCS7_DETACHED);
   // 将PenDataJSON存入签名字典
   signature.getCOSObject().setItem(new COSName("WacomBiometricData"), new COSString(penDataJson));
   // 配置签名外观，嵌入手写签名图片（此处省略）
   document.addSignature(signature);
   

3. 完成签名流程：调用PDFBox的签名API完成数字签名，确保PenData被嵌入签名字典，同时可视化签名正常显示。

四、合规性注意事项 #

• 保证PenData完整性：序列化嵌入时，建议将PenData的哈希值也作为签名属性的一部分，或纳入PAdES签名的哈希覆盖范围，防止数据篡改。
• 适配监管要求：金融、医疗等强合规场景，优先采用PAdES-Basic及以上等级的签名格式，确保生物特征数据可被审计溯源。

内容的提问来源于stack exchange，提问作者Alessandro Baroni