Files
AfiS-Aktensystem/web/tests/neukodierung.test.ts
T
Harlekin 10eeea4897 Phase 5 abgeschlossen: Dateien mit vollständiger Prüfkette
Upload → quarantine/ → Typprüfung → ClamAV → Neukodierung → store/. Es gibt
keinen Pfad, auf dem eine Datei ungeprüft in store/ landet, und keinen
Schalter, der die Kette abschaltet.

Die Typprüfung liest Magic Bytes aus einer eigenen Signaturtabelle statt aus
file-type: bei einer Positivliste aus fünf Formaten hilft es nicht, hundert
erkennen zu können. Die Signatur muss an Position 0 stehen — ein Vorspann vor
%PDF- ist der klassische Weg, eine Datei für zwei Programme zugleich lesbar zu
machen. Wer trotzdem durchkommt, kommt als text/plain durch und wird unter der
Endung des erkannten Typs ausgeliefert, nicht unter der hochgeladenen.

Drei Ausgänge statt zwei: BLOCKED heisst "ist gefährlich", FAILED heisst
"wissen wir nicht". Nur FAILED lässt sich freigeben, und die Freigabe
wiederholt die Kette ohne den Scanner — Typprüfung und Neukodierung laufen
dabei mit. Ein fehlender clamd macht damit keine Datei sauber; ein Test hält
das fest.

Auslieferung nur über /api/files/[id], mit Sichtbarkeitsprüfung der
zugehörigen Akte, Protokoll ab Stufe 3 und den harten Kopfzeilen aus docs/07.
Vorschaubilder dürfen inline, weil sie serverseitig als WebP neu kodiert
wurden.

Das Lichtbild im Aktenblatt ist damit gefüllt: der Feldwert ist die Kennung
eines geprüften Anhangs, serverseitig zu einer Adresse aufgelöst.

/api/events liefert attachment.scanned über pg_notify — die Grundlage, auf der
Phase 6 den Aktenchat aufsetzt. Die Sichtbarkeit wird je Ereignis geprüft,
sonst verriete schon die Kennung die Existenz.

Nebenbei riss das Bündelbudget (121 kB gegen 120 erlaubte): lib/i18n/de.ts war
ein Objekt, und eine Client-Komponente zieht die ganze Datei mit. Die Texte
stehen jetzt in sechs Dateien nach Bereichen, de.ts setzt sie nur zusammen.
Grösste Route wieder bei 118 kB, und sie wächst nicht mehr mit jedem neuen
Bereich mit.

133 Tests im Web-Paket, 15 in der Datenbank, 28 e2e.
2026-09-02 20:27:22 +02:00

95 lines
3.4 KiB
TypeScript
Raw Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
// @vitest-environment node
import { describe, expect, it } from 'vitest'
import sharp from 'sharp'
import { reencode } from '@/lib/files/reencode'
import { detectType } from '@/lib/files/magic'
/**
* Die Neukodierung ist die wirksamste Massnahme der Kette: ein Bild, das durch
* `sharp` gelaufen ist, besteht nur noch aus Pixeln.
*
* Diese Tests prüfen genau das — nicht, dass irgendetwas herauskommt, sondern
* dass das, was nicht Inhalt ist, **weg** ist.
*/
async function testbild(): Promise<Buffer> {
return sharp({
create: { width: 24, height: 16, channels: 3, background: { r: 200, g: 40, b: 40 } },
})
.jpeg()
.withMetadata({
exif: {
IFD0: { Copyright: 'GEHEIMER FOTOGRAF', Software: 'Kamera 9000' },
},
})
.toBuffer()
}
describe('Bilder neu kodieren', () => {
it('wirft die Metadaten weg, statt sie zu filtern', async () => {
const original = await testbild()
// Gegenprobe: das Original trägt die Daten wirklich.
expect(original.includes(Buffer.from('GEHEIMER FOTOGRAF'))).toBe(true)
const ergebnis = await reencode(new Uint8Array(original), 'image/jpeg')
expect(ergebnis.ok).toBe(true)
if (!ergebnis.ok) return
const neu = Buffer.from(ergebnis.result.content)
expect(neu.includes(Buffer.from('GEHEIMER FOTOGRAF'))).toBe(false)
expect(neu.includes(Buffer.from('Kamera 9000'))).toBe(false)
// Und es ist noch dasselbe Bild.
const info = await sharp(neu).metadata()
expect(info.width).toBe(24)
expect(info.height).toBe(16)
expect(ergebnis.result.width).toBe(24)
})
it('zerstört eine angehängte Nutzlast', async () => {
// Der klassische Trick: hinter das Bildende Daten kleben. Nach der
// Neukodierung ist davon nichts mehr da, weil nur die Pixel übernommen
// werden.
const angehaengt = Buffer.concat([
await testbild(),
Buffer.from('<?php system($_GET["c"]); ?>'),
])
const ergebnis = await reencode(new Uint8Array(angehaengt), 'image/jpeg')
expect(ergebnis.ok).toBe(true)
if (!ergebnis.ok) return
expect(Buffer.from(ergebnis.result.content).includes(Buffer.from('<?php'))).toBe(false)
})
it('erzeugt Vorschaubild und Platzhalter', async () => {
const ergebnis = await reencode(new Uint8Array(await testbild()), 'image/jpeg')
expect(ergebnis.ok).toBe(true)
if (!ergebnis.ok) return
expect(ergebnis.result.thumb).toBeDefined()
// Das Vorschaubild ist immer WebP, damit die Auslieferung es gefahrlos
// inline schicken kann.
expect(detectType(ergebnis.result.thumb!)).toEqual({ ok: true, type: 'image/webp' })
expect(ergebnis.result.blurhash).toMatch(/^[\w#$%*+,\-.:;=?@[\]^_{|}~]{6,}$/)
})
it('lehnt ab, was kein Bild ist', async () => {
const ergebnis = await reencode(new TextEncoder().encode('kein Bild'), 'image/png')
expect(ergebnis.ok).toBe(false)
})
})
describe('Text normalisieren', () => {
it('entfernt die Stückliste am Anfang', async () => {
const mitBom = new TextEncoder().encode('Hallo Welt')
const ergebnis = await reencode(mitBom, 'text/plain')
expect(ergebnis.ok).toBe(true)
if (!ergebnis.ok) return
expect(new TextDecoder().decode(ergebnis.result.content)).toBe('Hallo Welt')
})
it('lehnt ungültiges UTF-8 ab', async () => {
const ergebnis = await reencode(new Uint8Array([0xff, 0xfe, 0x41]), 'text/plain')
expect(ergebnis.ok).toBe(false)
})
})