Skip to content
Demo示例FAQ

PDF 生成模板编辑器

开源可视化 PDF 生成引擎,支持自定义模板,并提供面向开发者的 API,灵活构建文档生成流程。

查看 GitHub
Android Guides Timestamps

数字签名时间戳 ​

签名时间可来自设备时钟,也可由时间戳服务机构(TSA)提供。嵌入时间戳将 TSA 返回的 RFC 3161 时间戳令牌写入签名,时间戳的可信性仍需验证。

创建带嵌入时间戳的签名 ​

先按 创建数字签名 准备签名域、外观和 PKCS12 证书,再调用带 tsaUrl 的 writeSignature() 重载。

以下代码中的 signatureWidget 为当前文档的签名域,outputPath 为新的输出文件路径,tsaUrl 为应用配置的 TSA 地址。确保输出目录存在,并在后台线程执行签名;访问 TSA 需要 android.permission.INTERNET。

java
boolean signed = document.writeSignature(
    signatureWidget,
    outputPath,
    certificatePath,
    certificatePassword,
    "Shanghai",
    "Document approval",
    CPDFDocument.PDFDocMdpP.PDFDocMdpPForbidAllModify,
    tsaUrl
);
if (!signed) {
    // 签名未完成,检查证书、输出路径及 TSA 服务。
}
kotlin
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无可用时间戳来源;也应检查签名对象是否有效
java
for (int i = 0; i < signedDocument.getSignatureCount(); i++) {
    CPDFSignature signature = signedDocument.getPdfSignature(i);
    if (signature != null) {
        CPDFSignature.TimestampSource source = signature.getTimestampSource();
        // 根据 source 显示时间戳来源。
    }
}
kotlin
for (i in 0 until signedDocument.signatureCount) {
    val signature = signedDocument.getPdfSignature(i) ?: continue
    val source = signature.timestampSource
    // 根据 source 显示时间戳来源。
}

验证时间戳 ​

EMBEDDED 只说明时间戳存在。应通过 验证数字签名 中的 CPDFSignatureValidator,启用 setCheckTimestamp(true) 并配置可信证书路径,检查时间戳校验项和 TSA 证书链结果。

嵌入时间戳不代表已具备长期验证所需的全部材料。补充与检查这些材料,参见 长期验证与 PAdES 签名。