如何使用JavaScript构建基于浏览器的PDF密码保护工具

如何使用JavaScript构建基于浏览器的PDF密码保护工具

💡 原文英文,约5600词,阅读约需21分钟。
📝

内容提要

本文介绍如何用JavaScript在浏览器内为PDF添加AES-256密码保护,全程不上传服务器。作者用PDF-lib读取PDF,但因其不支持加密,需按PDF 2.0规范借助Web Crypto API自行实现:生成随机文件密钥,用慢哈希处理密码,构建U、UE、O、OE、Perms等加密字典值,加密所有字符串和流,并设置打印、复制、编辑权限。最后用PDF.js验证文件确实需要密码且能正常打开,再供用户下载。

🔎

延伸解读

权限控制并非安全边界

文章明确指出,PDF中的打印、复制、编辑权限只是存储在/P数字中的标志位,合规的阅读器会遵守,但任何忽略这些标志的程序在文件打开后仍可打印或复制。因此,若内容需要真正保密,必须依赖打开密码,而非权限设置。这一提醒有助于读者正确评估工具的安全能力,避免误以为勾选限制就万无一失。

加密实现中的关键陷阱

作者总结了多个易错点:不能使用Math.random()生成密钥或盐值,必须用crypto.getRandomValues();加密字典本身不能加密,否则阅读器无法验证密码;保存时需禁用对象流(useObjectStreams: false),否则字符串会被二次加密;向PDF.js传递数据时要slice()复制缓冲区,因其会转移所有权导致原数组变空。这些细节直接影响加密文件能否被正常打开。

验证环节的必要性

加密代码容易写出难以察觉的bug,文件可能在一个阅读器中打开却在另一个中失败,甚至根本没有加密。文章强调在提供下载前,用PDF.js做两项检查:无密码打开必须抛出PasswordException,有密码打开必须成功且页数与原文件一致。此外,建议用qpdf等外部工具严格校验,确保输出文件符合规范。

性能与文件大小的权衡

逐个加密对象可降低内存占用,因为一次只复制一个流;对于包含数千个小对象的文件,可分批用Promise.all加速。加密后文件会略微增大:每个字符串和流增加16字节IV和最多16字节填充,且禁用对象流会使交叉引用表变大。小文件可能翻倍,大文件仅增加几KB。验证时务必使用即将下载的同一份字节,避免重新加密导致检查失效。

❓

Q&A

为什么用JavaScript在浏览器里给PDF加密码比用在线工具更安全?

因为在线工具通常要求你先上传PDF文件,而文件一旦上传就离开了你的设备,存在隐私泄露风险。浏览器内加密则全程在本地进行,文件永远不会发送到服务器,原文件也不会被修改。

PDF加密时,文件里的哪些部分会被加密,哪些不会?

PDF加密时,所有的字符串(strings)和流(streams)都会被加密,但数字、名称以及对象之间的引用关系保持可读,这样PDF阅读器还能找到文件结构。加密字典本身也不能被加密,否则阅读器无法验证密码。

PDF 2.0的密码哈希算法是怎么工作的?为什么要用这么复杂的哈希?

PDF 2.0使用一种慢哈希算法(ISO 32000-2 Algorithm 2.B):先做SHA-256,然后至少进行64轮AES-128和SHA-256/384/512的混合运算,轮数和哈希函数的选择取决于数据本身。这样设计是为了增加暴力破解密码的成本,让攻击者难以用专用硬件加速猜测。

在代码中如何设置PDF的打印、复制和编辑权限?

权限存储在一个32位整数/P中,每个比特代表一种操作。例如,打印对应第3位和第12位(高质量打印),复制对应第5位,编辑对应第4、6、9、11位。代码中通过位运算组合这些标志,并确保保留位为1,最后转换为有符号32位整数。

构建这个PDF密码保护工具需要哪些库和浏览器API?

需要PDF-lib(用于读取和修改PDF对象)、PDF.js(用于验证加密结果)以及Web Crypto API(用于AES加密、SHA哈希和安全随机数生成)。PDF-lib本身不支持加密,所以加密部分需要自己用Web Crypto API实现。

加密后的PDF文件大小会明显增加吗?

文件会略微增大,因为每个字符串和流都会增加一个16字节的IV和最多16字节的填充,并且保存时不使用对象流会使交叉引用表变大。例如,4KB的文件可能变成8KB,而5MB的文件只会增加几KB。

如何验证生成的加密PDF确实需要密码才能打开?

可以使用PDF.js在浏览器中验证:先尝试不带密码打开,应该抛出PasswordException;再使用正确密码打开,应该成功并且页数与原始文件一致。此外,还可以用qpdf命令行工具检查加密设置,例如运行qpdf --check --password='your password' file.pdf来确认无错误。

开发这个工具时有哪些常见错误需要避免?

常见错误包括:在非安全上下文(如http://)下使用Web Crypto API会导致crypto.subtle未定义;使用Math.random()生成密钥或盐(应使用crypto.getRandomValues());错误地加密了加密字典本身;保存时使用了对象流导致字符串被二次加密;忘记对传递给PDF.js的字节数组进行slice()拷贝;以及将权限限制误认为安全措施(打开密码才是关键)。

🏷️

标签

➡️

继续阅读