如何加密/添加密码和权限到PDF文件 in C#

Curtis Chau
Curtis Chau
更新: 2026年8月2日

使用密码和特定权限保护 PDF 文件对于保护敏感文档免受未经授权的访问和篡改至关重要。 IronSecure Doc 的 [POST] 加密/添加密码和权限 API 提供了一种高效的方式,可以使用用户和所有者密码加密 PDF 文件,同时配置打印、表单填写、注释等权限。 该 API 可确保 PDF 文件得到全面保护并受到访问控制,因此非常适合用于法律、财务或个人文档。

拉取并启动 IronSecureDoc

如果您尚未运行 IronSecureDoc,请点击以下链接进行安装:

[POST] 加密/添加密码和权限 API

[POST] 加密/添加密码和权限 API 允许您通过使用密码加密 PDF 文档并为各种操作设置特定权限来添加安全层。 无论是授予读取权限、允许填写表单还是禁用打印,此 API 都允许您控制如何访问和修改 PDF 文件。

Swagger

Swagger 提供了一个用户友好的界面,可以交互式地测试此 API。 你可以用它发送测试请求并接收响应,而无需编写代码,这使其成为开发人员的绝佳工具。

使用 Swagger 编辑文本的步骤

  1. 访问Swagger UI:

如果您的API服务器在本地运行,您可以通过在网页浏览器中导航到http://localhost:8080/swagger/index.html来访问Swagger。

Swagger文档

  1. 定位API:

查找与加密/添加密码和权限相对应的[POST] /v1/document-services/pdfs/encrypt API。

修改文本

  1. 输入参数:

提供 API 所需的参数。 您可以上传一个示例 PDF 文件并指定所需的权限。

  1. 上传PDF文件:

在请求正文中,以pdf_file身份上传PDF文件并定义必要的权限,例如允许或限制打印、表单填写和内容提取。

  1. 执行请求:

所有参数设置完毕后,点击“执行”发送请求。系统将返回符合指定安全设置的加密 PDF 文件。

  1. 检查输出PDF:

输入“密码”即可查看PDF内容。


了解输入参数

该 API 需要特定的参数来加密 PDF 并分配权限。 以下是必填参数和可选参数的详细说明:

必需参数

名称数据类型说明
pdf_file应用程序/pdf您要加密的 PDF 文件。
allow_extracting_content布尔值指明是否允许提取内容。
allow_form_filling布尔值请说明是否允许填写表格。
allow_annotations布尔值请指明是否允许添加注释。
allow_printing布尔值请说明是否允许打印。
allow_modifications布尔值请说明是否允许修改。
new_owner_password字符串PDF 文件的新所有者密码,授予完全访问权限和更改权限的能力。

可选参数

名称数据类型说明
user_password字符串如果 PDF 文件需要用户密码才能授予读取权限,则需要输入当前用户密码。
owner_password字符串如果 PDF 文件设置了所有者密码,则需要输入当前所有者密码以授予完全访问权限。
new_user_password字符串新用户的读取权限密码。
save_as_pdfa布尔值将 PDF 文件另存为符合 PDF/A-3 标准的格式。
save_as_pdfua布尔值将 PDF 保存为符合 PDF/UA 规范的格式。
author字符串设置PDF元数据作者属性。
title字符串设置PDF元数据标题属性。
subject字符串设置PDF元数据主题属性。

API 集成:Python 示例

熟悉输入参数后,您可以使用 Python 或任何其他您喜欢的语言调用 API。 下面是一个使用 Python 集成此 API 的示例。

import requests

# Endpoint URL
url = 'http://localhost:8080/v1/document-services/pdfs/encrypt'

# Headers with metadata information
headers = {
    'accept': '*/*',
    'author': 'Iron Software',
    'title': 'ENCRYPTION DEMO 2024',
    'subject': 'DEMO EXAMPLE'
}

# Files to be sent in the request
files = {
    'pdf_file': ('sample.pdf', open('sample.pdf', 'rb'), 'application/pdf')
}

# Parameters for encryption and permissions
data = {
    'allow_extracting_content': 'true',
    'allow_form_filling': 'true',
    'allow_annotations': 'false',
    'allow_printing': 'false',
    'allow_modifications': 'true',
    'new_owner_password': 'password',
    'new_user_password': 'password',
    'save_as_pdfa': 'false',
    'save_as_pdfua': 'false'
}

# Send POST request with parameters
response = requests.post(url, headers=headers, files=files, data=data)

# Save the encrypted PDF to file system
with open('sample_encrypted.pdf', 'wb') as f:
    f.write(response.content)

print('PDF encrypted successfully.')
Python

步骤详解:

  • 加载PDF: 加载需要加密的PDF文件,该文件来自本地文件系统。
  • 设置加密参数: 定义权限,比如允许打印、填写表单和提取内容,以及设置新密码。
  • 调用API: 调用[POST]加密/添加密码和权限API,传递必要的参数。
  • 保存结果: 将加密后的PDF保存为一个新文件。

PDF 文件已加密,如下所示。 输入“密码”即可查看PDF内容。

常见问题

如何使用IronSecureDoc加密PDF文件?

您可以通过使用[POST] Encrypt/Add Password & Permissions API来使用IronSecureDoc加密PDF文件。这使您能够设定用户和所有者密码,并为PDF文档配置特定权限。

可以使用IronSecureDoc API配置哪些权限?

IronSecureDoc API允许您配置打印、表单填写、注释、内容提取和修改的权限,以确保您PDF文档所需的访问级别和安全性。

是否可以在不编写代码的情况下测试IronSecureDoc API?

是的,您可以使用Swagger交互式测试IronSecureDoc API,它提供了一个用户友好的界面来发送和接收请求和响应,提供了一种无需编写代码的测试体验。

如何将IronSecureDoc部署到云平台?

IronSecureDoc可以部署到Azure和AWS等云平台。在这些环境中部署IronSecureDoc的说明可在Iron Software网站上找到。

Docker镜像在使用IronSecureDoc中起什么作用?

IronSecureDoc Docker镜像是运行API服务所必需的。您可以获取并启动Docker镜像,以在本地或云环境中托管IronSecureDoc。

我可以使用IronSecureDoc创建符合PDF/A或PDF/UA标准的文件吗?

是的,IronSecureDoc提供了将PDF文件保存为符合PDF/A-3或PDF/UA标准的可选参数,以确保符合特定标准和可访问性。

为什么在PDF加密中使用所有者和用户密码很重要?

在PDF加密中,所有者和用户密码对于控制访问级别至关重要。所有者密码授予对文档的完全访问权限,而用户密码提供更有限的访问权限,以保护敏感信息。

哪些编程语言可以与IronSecureDoc API集成?

IronSecureDoc API可以与Python、C#和Java等多种编程语言集成,使得开发者在不同环境中工作时具有灵活性。

使用IronSecureDoc加密PDF所需的参数是什么?

所需的参数包括PDF文件本身以及多个权限设置,如允许内容提取、表单填写、注释、打印、修改和设置新的所有者密码。

使用IronSecureDoc提供了哪些PDF安全优势?

IronSecureDoc通过允许全面的加密和权限管理提供了一种可靠的PDF安全解决方案,使其适合保护法律、财务或个人文件免受未经授权的访问。

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位,专注于前端开发,精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面,喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

阅读更多

准备开始了吗?

版本:2024.10刚刚发布