Skip to content
Demo示例FAQ

PDF 生成模板编辑器

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

查看 GitHub
Android Guides Long term validation

长期验证与 PAdES 签名 ​

长期验证(LTV)使用文档中保存的证书及吊销信息,为后续验证提供材料。ComPDF 提供文档级材料评估、PAdES 签名及已签名文档的材料补充接口。

评估文档验证材料 ​

CPDFLtvService.assessReadiness(document) 检查已打开文档中的 DSS(文档安全存储)和 VRI(验证相关信息)材料,也包含尚未保存的内存状态。该操作应在后台线程执行。

java
import com.compdfkit.core.signature.CPDFLtvService;
import com.compdfkit.core.signature.CPDFLtvReadinessResult;
import com.compdfkit.core.signature.CPDFLtvReadinessInfo;

CPDFLtvReadinessResult result = CPDFLtvService.assessReadiness(document);
if (result != null && result.isSuccess()) {
    CPDFLtvReadinessInfo info = result.getReadinessInfo();
    if (info != null) {
        boolean ready = info.isLtvReady();
        String[] missingMaterials = info.getMissingMaterials();
        // 根据 ready 和 missingMaterials 显示材料准备情况。
    }
} else {
    // 检查文档是否已打开,并读取非空 result 中的 errors 和 warnings。
}
接口用途
hasDss()、hasVri()检查 DSS 和 VRI 是否存在
hasCertificates()、hasRevocation()检查证书材料及 OCSP/CRL 材料是否存在
isLtvReady()、getMissingMaterials()读取准备情况及缺失材料
getDssInfo()获取 DSS 材料数量等信息
getErrors()、getWarnings()从评估结果读取错误与警告

材料就绪不代表证书可信、吊销证据有效或全部签名均符合 PAdES-LT。完整验证参见 验证数字签名,并启用 setCheckRevocation(true)。

创建 PAdES 签名 ​

CPDFPadesSigner.sign() 根据 CPDFPadesOptions 创建签名域和外观,并按所选配置生成输出文件。

Profile输出阶段所需输出路径
B基础签名signedPath
T带签名时间戳signedPath
LT增加长期验证材料signedPath、ltvPath
LTA进一步增加文档时间戳signedPath、ltvPath、ltaPath

调用前保存所有待签内容。该接口从文件路径重新加载文档,不包含尚未保存的内存修改。所有输出路径应互不相同,并与源路径不同;先创建输出目录。网络请求应在后台线程执行,并配置 android.permission.INTERNET。

以下示例创建不可见的 LT 签名。trustedCertPath 为可信根证书 PEM 文件或 OpenSSL 格式的证书目录,tsaUrl 为可访问的 TSA 地址:

java
import com.compdfkit.core.signature.CPDFPadesOptions;
import com.compdfkit.core.signature.CPDFPadesResult;
import com.compdfkit.core.signature.CPDFPadesSigner;

CPDFPadesOptions options = new CPDFPadesOptions()
    .setProfile(CPDFPadesOptions.Profile.LT)
    .setCertificate(certificatePath, certificatePassword)
    .setFieldName("ApprovalSignature")
    .setVisible(false)
    .setTsaUrl(tsaUrl)
    .setTrustedCertPath(trustedCertPath);

CPDFPadesResult result = CPDFPadesSigner.sign(
    sourcePath, signedPath, ltvPath, null, options);
if (result != null && result.isSuccess()) {
    String finalPath = result.getFinalPath();
    // 使用最终阶段的文件。
} else {
    // 读取非空 result 中的 getErrors() 和 getWarnings()。
}

如需可见签名,可使用 setField(pageIndex, rect) 指定签名域,再配置外观。签名域名称不能与已有域重复。sign() 创建自己的签名域,不对已有签名域签名,也不设置 DocMDP 认证引用;需要这些行为时,使用 writeSignature() 后再补充 LTV 材料。

为已签名文档补充材料 ​

prolongLtv() 为已签名文件增量补充或刷新证书链、OCSP/CRL 材料,保留原签名域、外观和 DocMDP 引用。

java
CPDFPadesOptions options = new CPDFPadesOptions()
    .setTrustedCertPath(trustedCertPath);
CPDFPadesResult result = CPDFPadesSigner.prolongLtv(
    signedPath, ltvPath, null, options);
if (result != null && result.isSuccess()) {
    String finalPath = result.getFinalPath();
    // 打开最终文件并重新验证签名。
}

需要追加文档时间戳时,设置 setAppendDocumentTimestamp(true)、setLtaTsaUrl(tsaUrl) 并传入独立的 ltaPath。此流程读取信任、吊销材料与文档时间戳配置,不使用 profile、签名证书、签名域及外观设置。

Android 不为该接口提供默认 OpenSSL 信任库,应显式配置可信根证书。网络、证书链或材料获取失败时,读取结果中的错误与警告;不能只根据中间输出文件存在判断整个流程成功。