PDFsharp库的加密功能-学习笔记

PDFsharp库的加密功能介绍

官网

https://www.pdfsharp.net/wiki-1.5/ProtectDocument-sample.ashx

这是 PDFsharp 库（v1.5）中演示**如何对 PDF 文档加密保护**的官方示例。下面我将**全面详细地解读其加密功能**，并补充关键背景知识，便于你理解与实际使用：

🔐一、加密核心流程概览

PDFsharp 通过`PdfSecuritySettings` 类实现文档加密与权限控制，其基本流程为：

**打开一个已有 PDF 文档**（支持带密码打开，若不需要则忽略密码参数）；
**获取文档的`SecuritySettings` 对象**；
**设置用户/所有者密码** ------ 任一密码设置会自动启用 128 位加密；
**配置权限限制**（如禁止打印、禁止复制内容等）；
**保存文档**，生成加密保护后的 PDF。

🔑二、密码类型说明

PDF 标准支持两种密码角色，PDFsharp完全支持：

> ✅本例中：<br>

> - `UserPassword = "user"` → 打开文档需输 `"user"`<br>

> - `OwnerPassword = "owner"` → 网页提示"**The owner password is 'owner'**"，且截图显示 Adobe Reader 要求输入密码（推测演示时未设 UserPassword 或设为空，实际以 OwnerPassword 作后备验证------但按代码应输`"user"` 打开）

> **⚠️注意：Adobe Reader 处理逻辑较复杂，若未设 UserPassword，仅设 OwnerPassword，通常仍可打开但受权限限制；某些阅读器会提示输入 OwnerPassword 解锁权限。本例截图可能为简化演示。**

⚙️三、加密级别（Security Level）

PDFsharp 支持两种加密强度（对应 PDF 标准）：

>//securitySettings.DocumentSecurityLevel= PdfDocumentSecurityLevel.Encrypted40Bit;

> ```

> 📌注意：PDFsharp 1.5 **不支持 AES 256-bit 加密**（PDF 1.7+ 的新标准），如需更强加密，需升级到 PDFsharp-MigraDoc 1.6+ 或使用其他库（如 iText7、PdfiumViewer + 加密插件等）。

🛑四、权限控制项（Permissions）

通过 `PdfSecuritySettings` 可精细控制用户能做什么。所有权限默认为 `true`（允许），设置为 `false` 即**禁止**。

> 💡提示：某些权限在 Adobe Reader 中强制执行；但在其他 PDF 阅读器（尤其开源阅读器）中**可能被忽略**------PDF 权限本质是"君子协定"，防君子不防小人。

🧾五、完整代码逐行解析

javascript 复制代码

// 复制源文件（假设"HelloWorld.pdf" 存在于指定路径）File.Copy(Path.Combine("../../../../../PDFs/", filenameSource),Path.Combine(Directory.GetCurrentDirectory(), filenameDest), true);// 打开 PDF（密码参数若不需要会被忽略）PdfDocument document = PdfReader.Open(filenameDest, "some text"); // ← 这里密码无效，仅作演示// 获取安全设置对象PdfSecuritySettings securitySettings = document.SecuritySettings;// 设置密码 → 自动启用 128 位加密securitySettings.UserPassword = "user";securitySettings.OwnerPassword = "owner";// 权限设置（如前述表格）securitySettings.PermitAccessibilityExtractContent = false;securitySettings.PermitAnnotations = false;securitySettings.PermitAssembleDocument = false;securitySettings.PermitExtractContent = false;securitySettings.PermitFormsFill = true;securitySettings.PermitFullQualityPrint = false;securitySettings.PermitModifyDocument = true;securitySettings.PermitPrint = false;// 保存加密后文档document.Save(filenameDest);// 用默认程序打开（通常为Adobe Reader）Process.Start(filenameDest);

⚠️六、重要注意事项 & 局限性

**加密 ≠ 防破解**

PDF 权限可被专业工具（如 `qpdf`、`pdfcrack`）移除，尤其仅设 OwnerPassword 时；UserPassword 更难破解，但弱密码仍危险。

**兼容性问题**

手机端阅读器（如微信内置 PDF 查看）**常忽略权限**，直接显示/可复制；
部分浏览器 PDF 插件也不严格遵守权限。

**无障碍合规风险**

禁用 `PermitAccessibilityExtractContent` 可能使视障用户无法使用辅助工具，违反《Web 内容无障碍指南》（WCAG）。

**PDFsharp 1.5 限制**

仅支持 RC4 加密（40/128-bit），**不支持 AES-128 / AES-256**；
加密后的文档**元数据（如作者、标题）仍可能明文暴露**（需额外处理）；
**不支持数字签名**（需另寻方案）。

✅七、推荐实践建议