如何加密/添加密码和权限到PDF文件 in C#
使用密码和特定权限保护 PDF 文件对于保护敏感文档免受未经授权的访问和篡改至关重要。 IronSecure Doc 的 [POST] 加密/添加密码和权限 API 提供了一种高效的方式,可以使用用户和所有者密码加密 PDF 文件,同时配置打印、表单填写、注释等权限。 该 API 可确保 PDF 文件得到全面保护并受到访问控制,因此非常适合用于法律、财务或个人文档。
如何加密/添加密码和权限到PDF文件
- 拉取并启动IronSecureDoc Docker镜像
- 使用 Swagger 测试 API
- 指定密码和权限的参数
- 执行 API 调用以应用更改
- 导出加密的 PDF 文档
拉取并启动 IronSecureDoc
如果您尚未运行 IronSecureDoc,请点击以下链接进行安装:
[POST] 加密/添加密码和权限 API
[POST] 加密/添加密码和权限 API 允许您通过使用密码加密 PDF 文档并为各种操作设置特定权限来添加安全层。 无论是授予读取权限、允许填写表单还是禁用打印,此 API 都允许您控制如何访问和修改 PDF 文件。
Swagger
Swagger 提供了一个用户友好的界面,可以交互式地测试此 API。 你可以用它发送测试请求并接收响应,而无需编写代码,这使其成为开发人员的绝佳工具。
使用 Swagger 编辑文本的步骤
- 访问Swagger UI:
如果您的API服务器在本地运行,您可以通过在网页浏览器中导航到http://localhost:8080/swagger/index.html来访问Swagger。

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

- 输入参数:
提供 API 所需的参数。 您可以上传一个示例 PDF 文件并指定所需的权限。
- 上传PDF文件:
在请求正文中,以pdf_file身份上传PDF文件并定义必要的权限,例如允许或限制打印、表单填写和内容提取。
- 执行请求:
所有参数设置完毕后,点击“执行”发送请求。系统将返回符合指定安全设置的加密 PDF 文件。
- 检查输出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.')
步骤详解:
- 加载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。他热衷于打造直观且美观的用户界面,喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。