Подписание PDF через REST API — шаблон n8n
PDF-документы загружаются, подписываются цифровым сертификатом и становятся доступны для скачивания через workflow n8n с вебхуками для операций с файлами и сертификатами.
Оригинал на n8n.io: Create a REST API for PDF digital signatures with webhooks — Ferenc Erb
Открыть шаблон на n8n.io бесплатно- Сложность
- средний9 видов узлов
- Просмотров на n8n.io
- 5 902
- Опубликован
- Обновлён
- Автор
- Ferenc Erbпроверен n8n.io
- Сверено
Что делает шаблон
PDF-файлы принимаются через endpoint обработки документов, а подписанные документы можно скачать через отдельный endpoint. Для подписи используются PFX/PKCS#12-сертификат и его пароль; сертификат можно загрузить или создать с заданными атрибутами. Подпись встраивается в структуру PDF, исходный документ сохраняется. Запросы на загрузку используют multipart/form-data, а параметры создания сертификата и подписи передаются в JSON. В workflow настраиваются пути хранения файлов и обработка ошибок. Для работы нужны n8n версии 0.214.0 или выше, Node.js 14 или выше и разрешение внешних модулей через переменную окружения.
Как работает workflow по шагам
- Webhook принимает HTTP-запрос к endpoint обработки документов или скачивания.
- Switch направляет запрос к обработчику согласно переданному методу.
- If проверяет условия запроса, а Code выполняет обработку данных документа или сертификата.
- Read/Write Files from Disk сохраняет файлы или читает документ для дальнейшей обработки.
- Convert To File формирует файл для передачи в ответе.
- Respond to Webhook возвращает клиенту структурированный ответ.
Что нужно для запуска
- Установленный n8n версии 0.214.0 или выше.
- Node.js 14 или выше.
- Переменная NODE_FUNCTION_ALLOW_EXTERNAL со значениями node-forge,@signpdf/signpdf,@signpdf/signer-p12,@signpdf/placeholder-plain.
Как подключить сервисы к n8n
После импорта и активации workflow вебхуки принимают запросы по своим URL; эти адреса используются для интеграции с другими системами.
Что изменить под себя
- Пути хранения файлов задаются в переменных workflow, а для каталогов хранения настраиваются права доступа.
- Обработка ошибок настраивается под требования интеграции.
Кому подойдёт
Разработчикам и специалистам по автоматизации, которым нужна подпись документов через API, проверка документов или тестирование обработки PDF в среде разработки.
Узлы workflow 9
- If
- Edit Fields (Set)
- Webhook
- Switch
- Respond to Webhook
- Sticky Note
- Code
- Read/Write Files from Disk
- Convert to File
Виды узлов, из которых собран сценарий, — как их перечисляет страница шаблона. Серым — служебные узлы n8n.
Автор и первоисточник
Сценарий «Create a REST API for PDF digital signatures with webhooks» опубликовал на n8n.io Ferenc Erb. Файл шаблона и авторское описание — на странице шаблона.
Русское описание написано языковой моделью по странице шаблона и прошло автоматическую проверку: в нём нет сервисов и чисел, которых нет у автора. Сценарий принадлежит автору; каталог его не хранит.