Skip to content
Demo示例FAQ

PDF 生成模板编辑器

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

查看 GitHub
Android Guides Invisible digital signatures

不可见数字签名 ​

不可见数字签名不在页面上显示签名文字、图片或标识,但签名信息仍嵌入 PDF,可通过 ComPDF SDK 或 PDF 阅读器的签名面板查看和验证。

Android 3.2.0 可通过 CPDFPadesOptions.setVisible(false) 创建不可见签名,SDK 使用零尺寸签名域。将外观类型设为 AppearanceType.EMPTY,不配置文字、图片或标识外观。

不可见只影响页面外观,不改变签名完整性、证书有效期和证书信任的验证要求。

步骤 1:准备签名材料

先应用包含数字签名功能的许可证,并准备以下内容:

  • 已保存到本地文件、至少包含一页的输入 PDF。
  • 包含私钥、签名者证书及所需中间证书的 PKCS#12 文件(.p12 或 .pfx),以及证书密码。
  • 与输入文件不同的输出路径,父目录已存在且可写。
  • 用于验证证书链的可信根证书 PEM 文件或 OpenSSL 格式证书目录。

以下代码按顺序放在同一个方法中执行。context 为 Android Context,inputPath、outputPath、certificatePath、certificatePassword 和 trustedCertPath 由应用提供。签名与验证应在后台线程执行。

CPDFPadesSigner.sign() 从文件重新加载文档,不包含尚未保存的内存修改。签名前应保存待签内容,并检查输入文件可读、输出目录可写。

步骤 2:读取证书并检查有效期

getX509ByPKCS12Cert() 用于读取 PKCS#12 中的证书信息,不代表已建立证书信任。证书不可解析或密码错误时,检查返回对象是否有效。

java
import com.compdfkit.core.signature.CPDFSignature;
import com.compdfkit.core.signature.CPDFX509;

CPDFX509 certificate = CPDFSignature.getX509ByPKCS12Cert(
    certificatePath, certificatePassword);
if (certificate == null || !certificate.isValid()) {
    // 检查证书文件和密码。
    return;
}
if (certificate.isExpired()) {
    // 证书尚未生效、已过期或有效期无法解析。
    return;
}
kotlin
import com.compdfkit.core.signature.CPDFSignature
import com.compdfkit.core.signature.CPDFX509

val certificate = CPDFSignature.getX509ByPKCS12Cert(
    certificatePath, certificatePassword)
if (certificate == null || !certificate.isValid) {
    // 检查证书文件和密码。
    return
}
if (certificate.isExpired) {
    // 证书尚未生效、已过期或有效期无法解析。
    return
}

后续签名会从同一个 PKCS#12 文件加载私钥和签名身份。证书信息可读取且处于有效期内,不代表签名一定成功,也不代表该证书可信。

步骤 3:创建不可见签名

本例使用 Profile.B 创建基础签名,不请求 TSA 时间戳,也不补充长期验证材料。签名域放在第一页,名称为 InvisibleSignature;若文档已有同名签名域,应使用其他未占用的名称。

sign() 会自行创建签名域,无需提前调用 addFormWidget() 或更新签名外观。下面关闭自动签后验证,并在步骤 4 中显式验证输出,以区分文件生成结果与验证结论。

java
import android.graphics.RectF;
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.B)
    .setCertificate(certificatePath, certificatePassword)
    .setFieldName("InvisibleSignature")
    .setField(0, new RectF(0, 0, 0, 0))
    .setVisible(false)
    .setAppearanceType(CPDFPadesOptions.AppearanceType.EMPTY)
    .setSignerInfo("Approval", "Shanghai", "")
    .setVerifyAfterSign(false);

CPDFPadesResult signingResult = CPDFPadesSigner.sign(
    inputPath, outputPath, null, null, options);
if (signingResult == null || !signingResult.isSuccess()) {
    // 读取非空 signingResult 的 getErrors() 和 getWarnings()。
    return;
}
String signedPath = signingResult.getFinalPath();
kotlin
import android.graphics.RectF
import com.compdfkit.core.signature.CPDFPadesOptions
import com.compdfkit.core.signature.CPDFPadesResult
import com.compdfkit.core.signature.CPDFPadesSigner

val options = CPDFPadesOptions()
    .setProfile(CPDFPadesOptions.Profile.B)
    .setCertificate(certificatePath, certificatePassword)
    .setFieldName("InvisibleSignature")
    .setField(0, RectF(0f, 0f, 0f, 0f))
    .setVisible(false)
    .setAppearanceType(CPDFPadesOptions.AppearanceType.EMPTY)
    .setSignerInfo("Approval", "Shanghai", "")
    .setVerifyAfterSign(false)

val signingResult = CPDFPadesSigner.sign(
    inputPath, outputPath, null, null, options)
if (signingResult == null || !signingResult.isSuccess) {
    // 读取非空 signingResult 的 errors 和 warnings。
    return
}
val signedPath = signingResult.finalPath

sign() 不修改输入文件,也不为已有签名域签名。setVisible(false) 不等于禁止后续编辑;该接口不设置 DocMDP 认证引用,不能将其视为 iOS 示例中禁止修改权限的对应配置。

步骤 4:重新打开输出并验证签名

打开 signedPath 指向的实际输出文件,检查签名信息,并通过 CPDFSignatureValidator 验证本次签名域。trustedCertPath 应来自应用认可的信任配置,不能仅为通过验证而自动信任待验证证书。

java
import com.compdfkit.core.document.CPDFDocument;
import com.compdfkit.core.signature.CPDFSignatureValidationOptions;
import com.compdfkit.core.signature.CPDFSignatureValidationResult;
import com.compdfkit.core.signature.CPDFSignatureValidator;

CPDFDocument signedDocument = new CPDFDocument(context);
try {
    if (signedDocument.open(signedPath)
            != CPDFDocument.PDFDocumentError.PDFDocumentErrorSuccess) {
        return;
    }
    CPDFSignatureValidationOptions validationOptions =
        new CPDFSignatureValidationOptions()
            .setFieldName("InvisibleSignature")
            .setTrustedCertPath(trustedCertPath);
    CPDFSignatureValidationResult validation =
        CPDFSignatureValidator.validate(signedDocument, validationOptions);
    if (validation != null && validation.isSuccess()) {
        // 检查报告数量、getOverallStatus() 及各报告的 getItems()。
    } else {
        // 验证未执行成功,检查错误与警告。
    }
} finally {
    signedDocument.close();
}
kotlin
import com.compdfkit.core.document.CPDFDocument
import com.compdfkit.core.signature.CPDFSignatureValidationOptions
import com.compdfkit.core.signature.CPDFSignatureValidationResult
import com.compdfkit.core.signature.CPDFSignatureValidator

val signedDocument = CPDFDocument(context)
try {
    if (signedDocument.open(signedPath) !=
        CPDFDocument.PDFDocumentError.PDFDocumentErrorSuccess) {
        return
    }
    val validationOptions = CPDFSignatureValidationOptions()
        .setFieldName("InvisibleSignature")
        .setTrustedCertPath(trustedCertPath)
    val validation = CPDFSignatureValidator.validate(
        signedDocument, validationOptions)
    if (validation != null && validation.isSuccess) {
        // 检查报告数量、overallStatus 及各报告的 items。
    } else {
        // 验证未执行成功,检查错误与警告。
    }
} finally {
    signedDocument.close()
}

validation.isSuccess() 仅表示验证流程已执行成功。应检查是否返回了目标签名域的报告,并区分 VALID、INVALID、INDETERMINATE 和 NOT_CHECKED;不能仅凭流程成功认定签名有效。

默认验证包含签名完整性、覆盖范围、文档权限、证书链和时间戳检查,不包含吊销与 LTV 检查。未提供可信根证书时,证书链等检查可能返回不确定结论。详细结果解释参见 验证数字签名。

查看结果

输出 PDF 的页面不显示签名外观。可通过 getSignatureCount()、getPdfSignature() 读取签名,并使用 getFieldName()、getBounds()、getPageIndex(document) 等接口查看字段名、签名域范围和所在页。

签名不可见不会隐藏签名面板中的记录。使用自签名证书或验证设备缺少信任配置时,阅读器可能提示身份未知,应分别判断签名完整性和证书信任。

需要 TSA 时间戳或长期验证时,参见 数字签名时间戳 和 长期验证与 PAdES 签名。