PDF 生成模板编辑器
开源可视化 PDF 生成引擎,支持自定义模板,并提供面向开发者的 API,灵活构建文档生成流程。
签名时间可来自设备时钟,也可由时间戳服务机构(TSA)提供。嵌入时间戳将 TSA 返回的 RFC 3161 时间戳令牌写入签名,时间戳的可信性仍需验证。
先按 创建数字签名 准备签名域、外观和 PKCS12 证书,再调用带 tsaUrl 的 writeSignature() 重载。
以下代码中的 signatureWidget 为当前文档的签名域,outputPath 为新的输出文件路径,tsaUrl 为应用配置的 TSA 地址。确保输出目录存在,并在后台线程执行签名;访问 TSA 需要 android.permission.INTERNET。
boolean signed = document.writeSignature(
signatureWidget,
outputPath,
certificatePath,
certificatePassword,
"Shanghai",
"Document approval",
CPDFDocument.PDFDocMdpP.PDFDocMdpPForbidAllModify,
tsaUrl
);
if (!signed) {
// 签名未完成,检查证书、输出路径及 TSA 服务。
}val signed = document.writeSignature(
signatureWidget,
outputPath,
certificatePath,
certificatePassword,
"Shanghai",
"Document approval",
CPDFDocument.PDFDocMdpP.PDFDocMdpPForbidAllModify,
tsaUrl
)
if (!signed) {
// 签名未完成,检查证书、输出路径及 TSA 服务。
}TSA 无法访问或拒绝请求时,签名失败,不会自动回退为无时间戳签名。应用应检查返回结果。无需嵌入时间戳时,使用不带 tsaUrl 的重载。
开始签名后,源文档可能被标记为已修改;成功输出也不清除源文档的修改标记。应以返回值和独立打开的输出文件为准。
打开签名输出文件后,通过 CPDFSignature.getTimestampSource() 获取来源:
| 值 | 说明 |
|---|---|
EMBEDDED | 签名中包含嵌入时间戳 |
LOCAL_CLOCK | 仅包含签名者记录的本地时间 |
NONE | 无可用时间戳来源;也应检查签名对象是否有效 |
for (int i = 0; i < signedDocument.getSignatureCount(); i++) {
CPDFSignature signature = signedDocument.getPdfSignature(i);
if (signature != null) {
CPDFSignature.TimestampSource source = signature.getTimestampSource();
// 根据 source 显示时间戳来源。
}
}for (i in 0 until signedDocument.signatureCount) {
val signature = signedDocument.getPdfSignature(i) ?: continue
val source = signature.timestampSource
// 根据 source 显示时间戳来源。
}EMBEDDED 只说明时间戳存在。应通过 验证数字签名 中的 CPDFSignatureValidator,启用 setCheckTimestamp(true) 并配置可信证书路径,检查时间戳校验项和 TSA 证书链结果。
嵌入时间戳不代表已具备长期验证所需的全部材料。补充与检查这些材料,参见 长期验证与 PAdES 签名。