Basic PDF Digital Sign Service

工作流名称

Basic PDF Digital Sign Service

主要功能和亮点

该工作流实现了一个完整的PDF数字签名服务，支持数字证书的生成、证书和PDF文件的上传、PDF文件的数字签名以及签名后文件的下载。工作流包含多重参数校验，确保输入的正确性和安全性。利用Node.js的加密库（如node-forge）和专门的PDF签名库（@signpdf/signpdf），实现高效且安全的数字签名操作。

解决的核心问题

• 自动生成符合要求的数字证书与密钥文件（PFX、PEM格式）。
• 支持用户上传证书和待签名的PDF文件，并进行有效性校验。
• 实现PDF文件的数字签名，确保文件的完整性和身份认证。
• 通过API接口实现文件的上传、签名和下载全流程自动化。
• 提供错误处理和响应反馈，保障接口调用的稳定性。

应用场景

• 企业级电子文档管理系统中，自动化处理合同、协议等法律文件的数字签名。
• 需要远程或无纸化办公的场景，简化证书管理和文档签名流程。
• 开发数字签名API服务，供第三方系统调用。
• 任何需要合法且安全数字签名的PDF文件处理场景。

主要流程步骤

1. 请求接入与方法路由
   通过Webhook API接收POST请求，根据请求体中的method字段（upload、genKey、signPdf、download）进行操作分流。

2. 上传验证与存储

   • 根据上传类型（PDF文档或签名密钥）进行参数验证。
   • 将上传的文件数据转换为文件，写入服务器指定目录。

3. 数字证书及密钥生成

   • 验证生成证书所需参数（主题名、颁发者名、序列号、有有效期及密码）。
   • 使用node-forge生成RSA密钥对，创建自签名证书，输出PFX、PEM格式文件。

4. PDF数字签名

   • 验证签名所需参数（输入PDF文件名、PFX证书文件及密码）。
   • 读取PDF文件，添加签名占位符。
   • 使用P12证书对PDF进行数字签名，生成签名后的PDF文件。

5. 文件下载处理

   • 根据请求获取指定文件，设置响应头为附件，支持文件下载。

6. 响应反馈

   • 根据各步骤执行结果，返回成功或错误消息给调用方。

涉及的系统或服务

• n8n工作流自动化平台及其节点（Webhook、代码节点、文件读写节点、条件判断节点等）
• Node.js加密库：node-forge
• PDF签名相关库：@signpdf/signpdf、@signpdf/signer-p12、@signpdf/placeholder-plain
• 本地文件系统（用于临时存储上传和生成的文件）

适用人群或使用价值

• 软件开发者和系统集成商，需快速搭建数字证书管理与PDF签名功能接口。
• 企业IT部门，希望自动化处理电子文档的签名与管理，提升办公效率。
• 法律、财务等行业专业人员，确保文档的真实性和安全性。
• 需要远程调用数字签名服务的第三方应用开发者。

---

该工作流通过模块化设计，实现了数字证书的生成、上传管理、PDF数字签名及文件下载的全流程自动化。其严密的参数校验与错误反馈机制保障了服务的可靠性与安全性，是构建电子签名平台或集成数字签名功能的理想解决方案。