PDF 生成模板编辑器
开源可视化 PDF 生成引擎,支持自定义模板,并提供面向开发者的 API,灵活构建文档生成流程。
不可见数字签名不在页面上显示签名文字、图片或标识,但签名信息仍嵌入 PDF,可通过 ComPDF SDK 或 PDF 阅读器的签名面板查看和验证。
Android 3.2.0 可通过 CPDFPadesOptions.setVisible(false) 创建不可见签名,SDK 使用零尺寸签名域。将外观类型设为 AppearanceType.EMPTY,不配置文字、图片或标识外观。
不可见只影响页面外观,不改变签名完整性、证书有效期和证书信任的验证要求。
步骤 1:准备签名材料
先应用包含数字签名功能的许可证,并准备以下内容:
.p12 或 .pfx),以及证书密码。以下代码按顺序放在同一个方法中执行。context 为 Android Context,inputPath、outputPath、certificatePath、certificatePassword 和 trustedCertPath 由应用提供。签名与验证应在后台线程执行。
CPDFPadesSigner.sign() 从文件重新加载文档,不包含尚未保存的内存修改。签名前应保存待签内容,并检查输入文件可读、输出目录可写。
步骤 2:读取证书并检查有效期
getX509ByPKCS12Cert() 用于读取 PKCS#12 中的证书信息,不代表已建立证书信任。证书不可解析或密码错误时,检查返回对象是否有效。
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;
}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 中显式验证输出,以区分文件生成结果与验证结论。
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();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.finalPathsign() 不修改输入文件,也不为已有签名域签名。setVisible(false) 不等于禁止后续编辑;该接口不设置 DocMDP 认证引用,不能将其视为 iOS 示例中禁止修改权限的对应配置。
步骤 4:重新打开输出并验证签名
打开 signedPath 指向的实际输出文件,检查签名信息,并通过 CPDFSignatureValidator 验证本次签名域。trustedCertPath 应来自应用认可的信任配置,不能仅为通过验证而自动信任待验证证书。
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();
}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 签名。