CypherScan

Über

Das Plugin hängt einen beforeChange-Hook an die ausgewählten Upload-Collections in Payload CMS an. Jede eingehende Datei wird vor dem Speichern an die CypherScan-API geleitet. Der Scan-Vorgang ist zustandslos: Das Plugin fordert eine presigned S3-URL an, lädt die Datei in einen temporären Zwischenspeicher hoch, löst den Scan aus und liest das Ergebnis. CypherScan liefert vier Verdicts: clean, suspicious, malicious und unknown. Dateien mit einem Verdict, das auf der Blockliste steht, werden im Hook abgewiesen und gelangen nicht in Payload. Die Standardkonfiguration blockiert die Verdicts suspicious und malicious. Die Liste ist über die Option blockVerdicts frei konfigurierbar. Bereinigte Dateien passieren den Hook unverändert. Die Konfiguration umfasst apiKey, apiUrl, collections, blockVerdicts und failOpen. Mit collections lässt sich der Scan auf bestimmte Upload-Collections beschränken. failOpen steuert das Verhalten bei Ausfall der Scan-API. Ist failOpen aktiv (Standard), werden Uploads trotz unreachable API zugelassen. Das eignet sich für die Entwicklung. In Produktivumgebungen mit strengen Anforderungen kann failOpen deaktiviert werden, um Uploads im Fehlerfall abzuweisen. CypherScan ist als Peer-Dependency für Payload CMS 3 (payload ^3.0.0) ausgelegt und setzt einen CypherScan-API-Key voraus. Alle Schritte wie Dateiname, Typ, Größe, Presign-Status und Verdict werden über den Payload-Logger protokolliert. Da die Blockierung synchron beim Upload erfolgt, addiert sich die Scan-Latenz zu jeder Upload-Anfrage.

Paketinformationen

Paketname

cypherscan-payload

Neueste Version

0.1.6

Entpackte Größe

19 kB

Lizenz

MIT

Wöchentliche Downloads

2

Zuletzt veröffentlicht

16. Aug. 2026