CypherScan

Описание

Плагин перехватывает файлы, загружаемые в upload-коллекции Payload CMS, и передает их в сервис CypherScan до записи в хранилище. Для каждой выбранной коллекции навешивается хук `beforeChange`, поэтому файл проверяется до того, как попадет на диск или в подключенный storage adapter. Процесс сканирования построен на presigned S3 URL. При загрузке плагин запрашивает у CypherScan API временный URL, отправляет в него исходный файл, запускает проверку и получает вердикт: `clean`, `suspicious`, `malicious` или `unknown`. Файлы с вердиктом из `blockVerdicts` отклоняются прямо в хуке и не появляются в Payload. Чистые файлы проходят дальше без изменений. По умолчанию блокируются вердикты `suspicious` и `malicious`, список можно изменить. Конфигурация минимальная: нужны `apiKey` и `apiUrl` CypherScan. Опция `collections` ограничивает проверку конкретными upload-коллекциями. Параметр `failOpen` управляет поведением при недоступности API: при `true` (значение по умолчанию) загрузка проходит, при `false` файл отклоняется. Второй режим подходит для продакшена, где важна строгая блокировка. Плагин работает с Payload CMS 3 и выше (peer dependency `payload ^3.0.0`) и требует ключ CypherScan API. Каждый этап проверки (имя файла, тип, размер, статус presign, вердикт) пишется в стандартный лог Payload. Блокировка синхронная в момент загрузки, поэтому задержка сканирования добавляется к времени каждого запроса на загрузку файла.

О пакете

Имя пакета

cypherscan-payload

Последняя версия

0.1.6

Размер

19 кБ

Лицензия

MIT

Загрузок в неделю

2

Последняя публикация

16 авг. 2026 г.