如何使用 iText 7 提取 PDF 数字签名的原始待签名字节内容

酷伟吖_1520

酷伟吖_1520

2026-11-20

253人浏览

原创

如何使用 iText 7 提取 PDF 数字签名的原始待签名字节内容

iText 7 本身未提供类似 PDFBox 的 getSignedContent() 方法,但可通过解析签名字段的 /ByteRange 属性,结合随机读取文件视图,精准提取被签名覆盖前的原始字节序列(即签名域占位区之外的完整 PDF 内容)。

itext 7 本身未提供类似 pdfbox 的 `getsignedcontent()` 方法,但可通过解析签名字段的 `/byterange` 属性,结合随机读取文件视图,精准提取被签名覆盖前的原始字节序列(即签名域占位区之外的完整 pdf 内容)。

在数字签名验证或自定义签名流程中,获取 PDF 的“已签名内容”(signed content)至关重要——它并非原始 PDF 文件,也不是签名前的完整文件,而是根据 /ByteRange 字段排除签名值占位区域后、由剩余字节拼接而成的确定性字节流。该字节流正是签名算法(如 SHA256)实际计算摘要的对象。

iText 7 中,PdfSignature 对象可通过 getByteRange() 获取一个三元 PdfArray,其格式为 [0, offset1, offset2, length],表示签名覆盖范围:第一段从字节 0 到 offset1-1,第二段从 offset2 开始、长度为 length。中间被跳过的区间(即 offset1 到 offset2-1)正是签名值(/Contents)将被写入的位置,因此需被排除。

以下是一个安全、高效的提取示例(适用于 iText 7.2+):

WorkAny
WorkAny

WorkAny是一款AI智能体工具,本地运行的开源AI桌面智能体。

下载
import com.itextpdf.kernel.pdf.*;
import com.itextpdf.kernel.pdf.filespec.PdfFileSpec;
import com.itextpdf.kernel.utils.RandomAccessSourceFactory;
import com.itextpdf.kernel.utils.RASInputStream;

import java.io.*;
import java.util.Arrays;

public byte[] extractSignedContent(PdfDocument pdfDoc, PdfSignature signature) throws IOException {
    PdfArray byteRange = signature.getByteRange();
    if (byteRange == null || byteRange.size() != 4) {
        throw new IllegalArgumentException("Invalid or missing /ByteRange in signature");
    }

    long[] range = byteRange.toLongArray();
    // range[0] = 0, range[1] = first segment end, range[2] = second segment start, range[3] = second segment length

    PdfReader reader = pdfDoc.getReader();
    RandomAccessFileOrArray raf = reader.getSafeFile();

    try (ByteArrayOutputStream baos = new ByteArrayOutputStream();
         InputStream rangedStream = new RASInputStream(
                 new RandomAccessSourceFactory().createRanged(
                         raf.createSourceView(), range))) {

        byte[] buf = new byte[8192];
        int n;
        while ((n = rangedStream.read(buf)) != -1) {
            baos.write(buf, 0, n);
        }
        return baos.toByteArray();
    }
}

✅ 关键说明与注意事项:

  • 必须使用 reader.getSafeFile() 获取底层文件句柄,确保支持随机访问;若 PDF 来源于内存流(如 new PdfReader(new ByteArrayInputStream(...))),需提前将其持久化为临时文件或使用 RandomAccessSource 的内存实现(如 new RandomAccessSourceFactory().createSource(new ByteArrayInputStream(...)))。
  • /ByteRange 是 PDF 签名标准强制字段,但仅对 已签名 的文档有效;未签名或签名损坏的文档中该字段可能缺失或无效。
  • 提取结果为原始二进制字节(非 Base64、非 DER),可直接用于哈希计算(例如 MessageDigest.getInstance("SHA-256").digest(extractedBytes))以验证签名有效性。
  • 不建议直接修改或重写该字节流——它仅用于验证目的;任何变更都将导致签名失效。

综上,虽然 iText 7 没有开箱即用的 getSignedContent(),但通过合理组合 PdfSignature.getByteRange() 与 RandomAccessSourceFactory.createRanged(),即可可靠、高效地还原出签名所依据的原始内容字节,满足合规性验证、签名调试及高级签名集成等核心需求。

相关文章

极轻PDF
极轻PDF

专业的在线PDF工具,支持PDF编辑、转换、合并、压缩等多种功能,操作简单,处理高效,满足日常办公与学习中的PDF处理需求。

下载

相关标签:

字节

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

12997

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

10062

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

8532

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1364

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

1068

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1616

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

3409

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20611

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1475

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程