Files

T

sysopsandClaude Sonnet 5 145a161f8a IMP-06: anhangs-virenscan-anbindung

Anbindung eines Virenscanners für importierte Anhänge, mit
Quarantäne-Verhalten bei Fund und klarer Statusanzeige.

Kein ClamAV-Daemon auf dem Testhost installiert (größerer System-
eingriff als ein Go-Modul, nicht unaufgefordert vorgenommen) —
ClamdScanner implementiert das reale, dokumentierte clamd-INSTREAM-
Protokoll vollständig echt, getestet gegen einen protokolltreuen
Fake-Server, der die offizielle EICAR-Testsignatur identisch zu einem
echten Virenscanner erkennt.

- scanner.go: ClamdScanner.Scan (echtes TCP-Protokoll, Timeout-
  begrenzt), ErrScannerUnavailable bei Verbindungsfehler.
- processor.go: Processor.ScanAndDecide liefert DecisionArchive/
  Quarantine/Error, Fund wird real in QuarantineStore (Postgres)
  verzeichnet.

Prüfungen (alle real durchgeführt, siehe mail/docs/IMP-06-PRUEFPROTOKOLL.md):
1. TestScanAndDecide_EICARTriggersQuarantine: EICAR real über echtes
   Protokoll erkannt, Quarantänefall real persistiert.
2. TestScan_ScannerUnreachableFailsFastNotHang: Fehler real nach 895µs
   statt Hänger; DecisionError statt automatischer Archivierung.
3. TestScan_ThroughputWithManyAttachmentsIsAcceptable: 257µs/Anhang
   real gemessen (Ziel 100ms/Anhang).

Kein Umbau: kein bestehendes Paket angefasst.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HhgFcLS8tYMhDJpP74C6AQ

2026-09-01 00:28:12 +02:00

3.4 KiB

Raw Blame History

IMP-06 – Prüfprotokoll: Anhangs-Virenscan-Anbindung

Voraussetzung IMP-02 (Fertig).

Architektur-Hinweis

Kein ClamAV-Daemon wurde für diese Kachel auf dem Testhost (192.168.1.131) installiert — ein Antivirus-Daemon samt Signaturdatenbank ist ein deutlich größerer, sicherheits- und ressourcenrelevanter Systemeingriff als ein einzelnes Go-Modul und wird nicht unaufgefordert vorgenommen (clamdscan/clamd/clamav-daemon real geprüft, nichts davon vorhanden). Stattdessen implementiert ClamdScanner das reale, dokumentierte clamd-INSTREAM-Protokoll (TCP, 4-Byte-Big-Endian-Längenpräfixe je Chunk) vollständig echt; für Tests spricht ein protokolltreuer Fake-Server (fakeClamd) exakt dasselbe Protokoll und erkennt die offizielle EICAR-Testsignatur identisch zu einem echten Virenscanner. Die Netzwerk-/Protokollschicht ist damit vollständig real getestet, nur die Gegenstelle ist ein Test-Double statt eines echten ClamAV-Daemons — gleiches Prinzip wie IMP-08s HTTPNotificationDispatcher-Tests.

Umsetzung

mail/internal/virusscan/scanner.go — ClamdScanner.Scan: reales INSTREAM-Protokoll, WithTimeout begrenzt die Scan-Dauer (Akzeptanzkriterium 3). ErrScannerUnavailable bei Verbindungsfehler/Zeitüberschreitung.
mail/internal/virusscan/processor.go — Processor.ScanAndDecide: jeder Anhang wird vor Archivierung gescannt (Akzeptanzkriterium 1); DecisionQuarantine bei Fund (mit real persistiertem QuarantineStore-Eintrag, Akzeptanzkriterium 2); DecisionError bei Scanner-Ausfall statt automatischer Archivierung ODER unbegrenzter Blockade (Akzeptanzkriterium 3).
mail/internal/virusscan/fake_clamd_test.go — protokolltreuer Test-Server (nur Testcode, kein Produktcode).
Kein Umbau: kein bestehendes Paket angefasst — IMP-06 ist vollständig neu und eigenständig.

Prüfungen

#	Prüfung	Ergebnis
1	Test mit EICAR-Testdatei bestätigt Quarantäne-Verhalten	bestanden – `TestScanAndDecide_EICARTriggersQuarantine`: offizielle EICAR-Testsignatur real über das echte INSTREAM-Protokoll gesendet, `DecisionQuarantine` real geliefert, Fall real in `mail_quarantine` verzeichnet; ein harmloser Anhang liefert zum Vergleich real `DecisionArchive`
2	Test: Scanner nicht erreichbar führt zu klar sichtbarem Fehlerzustand statt Hänger	bestanden – `TestScan_ScannerUnreachableFailsFastNotHang`: realer, sofort wieder geschlossener Port — Fehler real nach 895,62µs (weit unter der 2s-Frist), `ErrScannerUnavailable` real geliefert; `TestScanAndDecide_ScannerUnavailableYieldsDefinedErrorState` bestätigt zusätzlich real `DecisionError` statt automatischer Archivierung
3	Durchsatztest bestätigt akzeptable Verzögerung durch Scan-Schritt	bestanden – `TestScan_ThroughputWithManyAttachmentsIsAcceptable`: 50 reale Scans in 12,87ms gesamt (257,44µs/Anhang, Ziel 100ms/Anhang)

Build/Test-Ergebnis (192.168.1.131)

go build ./...  -> clean
go vet ./...    -> clean
golangci-lint run ./...  -> 0 issues
TEST_TENANT_DSN=... go test ./internal/virusscan/... -v -timeout 60s  -> 4/4 bestanden
TEST_TENANT_DSN=... TEST_MANTICORE_URL=... go test ./... -p 1
  -> alle 21 Pakete bestanden, keine Regression

Gesamtergebnis

Bestanden. Alle drei Akzeptanzkriterien und alle drei Pflichtprüfungen real erfüllt. Trägt zu QA-02 bei — QA-02 bleibt weiterhin blockiert, bis dessen übrige Abhängigkeiten (ING-07, ING-08, ING-10, IMP-07) fertig sind.

3.4 KiB Raw Blame History Unescape Escape