Basic PDF Digital Sign Service

工作流名称

主要功能和亮点

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

解决的核心问题

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

应用场景

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

主要流程步骤

请求接入与方法路由
通过Webhook API接收POST请求，根据请求体中的method字段（upload、genKey、signPdf、download）进行操作分流。
上传验证与存储
- 根据上传类型（PDF文档或签名密钥）进行参数验证。
- 将上传的文件数据转换为文件，写入服务器指定目录。
数字证书及密钥生成
- 验证生成证书所需参数（主题名、颁发者名、序列号、有有效期及密码）。
- 使用node-forge生成RSA密钥对，创建自签名证书，输出PFX、PEM格式文件。
PDF数字签名
- 验证签名所需参数（输入PDF文件名、PFX证书文件及密码）。
- 读取PDF文件，添加签名占位符。
- 使用P12证书对PDF进行数字签名，生成签名后的PDF文件。
文件下载处理
- 根据请求获取指定文件，设置响应头为附件，支持文件下载。
响应反馈
- 根据各步骤执行结果，返回成功或错误消息给调用方。

涉及的系统或服务

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

适用人群或使用价值

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

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