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.
This commit is contained in:
Harlekin
@@ -0,0 +1,111 @@
|
||||
import { getCurrentUser } from '@/lib/auth/current'
|
||||
import { db } from '@/lib/db'
|
||||
import { visibleAttachmentWhere } from '@/lib/access/attachmentFilter'
|
||||
import { ensureListening, subscribe } from '@/lib/realtime/listener'
|
||||
import { ATTACHMENT_CHANNEL } from '@/lib/realtime/publish'
|
||||
|
||||
export const runtime = 'nodejs'
|
||||
export const dynamic = 'force-dynamic'
|
||||
|
||||
/** Damit Zwischenspeicher und Tunnel die Verbindung nicht für tot halten. */
|
||||
const HEARTBEAT_MS = 25_000
|
||||
|
||||
/**
|
||||
* Ereignisstrom für offene Ansichten.
|
||||
*
|
||||
* Nur `attachment.scanned` bislang; der Aktenchat kommt in Phase 6 dazu und
|
||||
* benutzt denselben Weg. Server-Sent Events und kein WebSocket: die Richtung
|
||||
* ist einseitig, es geht durch jeden Tunnel, und der Browser baut die
|
||||
* Verbindung von selbst wieder auf.
|
||||
*
|
||||
* **Die Sichtbarkeitsprüfung läuft je Ereignis.** Ein Ereignis über einen
|
||||
* Anhang, dessen Akte der Empfänger nicht sehen darf, wird nicht zugestellt —
|
||||
* sonst verriete schon die Kennung die Existenz.
|
||||
*/
|
||||
export async function GET(request: Request): Promise<Response> {
|
||||
const user = await getCurrentUser()
|
||||
if (!user) return new Response(null, { status: 404 })
|
||||
|
||||
await ensureListening()
|
||||
|
||||
const encoder = new TextEncoder()
|
||||
let heartbeat: ReturnType<typeof setInterval> | null = null
|
||||
let unsubscribe: (() => void) | null = null
|
||||
|
||||
const stream = new ReadableStream({
|
||||
start(controller) {
|
||||
const send = (event: string, data: unknown) => {
|
||||
try {
|
||||
controller.enqueue(
|
||||
encoder.encode(`event: ${event}\ndata: ${JSON.stringify(data)}\n\n`),
|
||||
)
|
||||
} catch {
|
||||
// Verbindung schon zu; das Aufräumen übernimmt cancel().
|
||||
}
|
||||
}
|
||||
|
||||
send('ready', { at: new Date().toISOString() })
|
||||
heartbeat = setInterval(() => {
|
||||
try {
|
||||
controller.enqueue(encoder.encode(': ping\n\n'))
|
||||
} catch {
|
||||
// s. o.
|
||||
}
|
||||
}, HEARTBEAT_MS)
|
||||
|
||||
unsubscribe = subscribe((event) => {
|
||||
if (event.channel !== ATTACHMENT_CHANNEL) return
|
||||
void zustellen(event.payload, user.permissions, send)
|
||||
})
|
||||
|
||||
request.signal.addEventListener('abort', () => {
|
||||
controller.close()
|
||||
})
|
||||
},
|
||||
cancel() {
|
||||
if (heartbeat) clearInterval(heartbeat)
|
||||
unsubscribe?.()
|
||||
},
|
||||
})
|
||||
|
||||
return new Response(stream, {
|
||||
headers: {
|
||||
'Content-Type': 'text/event-stream; charset=utf-8',
|
||||
'Cache-Control': 'no-cache, no-transform',
|
||||
Connection: 'keep-alive',
|
||||
// Der Tunnel darf nicht puffern, sonst kommt alles am Stück.
|
||||
'X-Accel-Buffering': 'no',
|
||||
},
|
||||
})
|
||||
}
|
||||
|
||||
async function zustellen(
|
||||
attachmentId: string,
|
||||
permissions: Awaited<ReturnType<typeof getCurrentUser>> extends infer U
|
||||
? U extends { permissions: infer P }
|
||||
? P
|
||||
: never
|
||||
: never,
|
||||
send: (event: string, data: unknown) => void,
|
||||
): Promise<void> {
|
||||
try {
|
||||
const anhang = await db.attachment.findFirst({
|
||||
where: { AND: [visibleAttachmentWhere(permissions), { id: attachmentId }] },
|
||||
select: {
|
||||
id: true,
|
||||
scanStatus: true,
|
||||
scanMessage: true,
|
||||
mimeType: true,
|
||||
sizeBytes: true,
|
||||
thumbKey: true,
|
||||
blurhash: true,
|
||||
width: true,
|
||||
height: true,
|
||||
},
|
||||
})
|
||||
if (!anhang) return
|
||||
send('attachment.scanned', { ...anhang, hasThumb: anhang.thumbKey !== null, thumbKey: undefined })
|
||||
} catch (error) {
|
||||
console.error('[events] Ereignis nicht zugestellt', error)
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,108 @@
|
||||
import { createReadStream } from 'node:fs'
|
||||
import { stat } from 'node:fs/promises'
|
||||
import { Readable } from 'node:stream'
|
||||
import { NextResponse } from 'next/server'
|
||||
import { db } from '@/lib/db'
|
||||
import { getCurrentUser } from '@/lib/auth/current'
|
||||
import { recordRead, READ_AUDIT_FROM_LEVEL } from '@/lib/audit'
|
||||
import { loadDeliverable } from '@/lib/files/service'
|
||||
import { absolutePath } from '@/lib/files/paths'
|
||||
import { deliveryFileName } from '@/lib/files/delivery'
|
||||
|
||||
export const runtime = 'nodejs'
|
||||
export const dynamic = 'force-dynamic'
|
||||
|
||||
/**
|
||||
* Auslieferung. **Niemals als statische Datei** — jeder Abruf läuft durch die
|
||||
* Sichtbarkeitsprüfung der zugehörigen Akte und wird ab Stufe 3 protokolliert.
|
||||
* Siehe docs/07-dateien-und-sicherheit.md.
|
||||
*
|
||||
* Die Kopfzeilen sind der zweite Schutzwall hinter der Neukodierung: selbst
|
||||
* eine durchgerutschte Datei kann im Browser nichts ausführen. `sandbox` ohne
|
||||
* Wert verbietet Skripte, Formulare und eigene Herkunft zugleich.
|
||||
*/
|
||||
export async function GET(
|
||||
request: Request,
|
||||
context: { params: Promise<{ id: string }> },
|
||||
): Promise<Response> {
|
||||
const user = await getCurrentUser()
|
||||
// Nicht angemeldet ist hier 404 und nicht 401: die Existenz einer Datei ist
|
||||
// selbst eine Information.
|
||||
if (!user) return new NextResponse(null, { status: 404 })
|
||||
|
||||
const { id } = await context.params
|
||||
const anhang = await loadDeliverable(user.permissions, id)
|
||||
if (!anhang) return new NextResponse(null, { status: 404 })
|
||||
|
||||
const variante = new URL(request.url).searchParams.get('variant')
|
||||
const vorschau = variante === 'thumb' && anhang.thumbKey !== null
|
||||
const key = vorschau ? anhang.thumbKey! : anhang.storageKey
|
||||
|
||||
let groesse: number
|
||||
try {
|
||||
groesse = (await stat(absolutePath(key))).size
|
||||
} catch {
|
||||
return new NextResponse(null, { status: 404 })
|
||||
}
|
||||
|
||||
await protokolliereAbruf(user.id, user.permissions.clearanceLevel, anhang)
|
||||
|
||||
// Die Endung folgt dem erkannten Typ, nicht dem hochgeladenen Namen.
|
||||
const name = deliveryFileName(anhang.originalName, anhang.mimeType)
|
||||
|
||||
const headers = new Headers({
|
||||
'Content-Type': vorschau ? 'image/webp' : anhang.mimeType,
|
||||
'Content-Length': String(groesse),
|
||||
'X-Content-Type-Options': 'nosniff',
|
||||
'Cache-Control': 'private, max-age=31536000, immutable',
|
||||
'Content-Security-Policy': "default-src 'none'; sandbox",
|
||||
// Vorschaubilder dürfen inline, sie sind serverseitig neu kodiert worden
|
||||
// und immer WebP. Alles andere wird heruntergeladen, nie angezeigt.
|
||||
'Content-Disposition': vorschau
|
||||
? 'inline'
|
||||
: `attachment; filename="${name}"; filename*=UTF-8''${encodeURIComponent(name)}`,
|
||||
})
|
||||
|
||||
const stream = Readable.toWeb(createReadStream(absolutePath(key))) as ReadableStream
|
||||
return new NextResponse(stream, { headers })
|
||||
}
|
||||
|
||||
/**
|
||||
* Ein Anhang erbt die Stufe seines Besitzers. Für die Protokollpflicht ab
|
||||
* Stufe 3 muss sie deshalb nachgeschlagen werden.
|
||||
*/
|
||||
async function protokolliereAbruf(
|
||||
userId: string,
|
||||
clearanceLevel: number,
|
||||
anhang: { id: string; caseId: string | null; entryId: string | null; documentId: string | null },
|
||||
): Promise<void> {
|
||||
const stufe = anhang.caseId
|
||||
? (await db.case.findUnique({ where: { id: anhang.caseId }, select: { classification: true } }))
|
||||
?.classification
|
||||
: anhang.entryId
|
||||
? (
|
||||
await db.caseEntry.findUnique({
|
||||
where: { id: anhang.entryId },
|
||||
select: { case: { select: { classification: true } } },
|
||||
})
|
||||
)?.case.classification
|
||||
: anhang.documentId
|
||||
? (
|
||||
await db.document.findUnique({
|
||||
where: { id: anhang.documentId },
|
||||
select: { classification: true },
|
||||
})
|
||||
)?.classification
|
||||
: 0
|
||||
|
||||
if ((stufe ?? 0) >= READ_AUDIT_FROM_LEVEL) {
|
||||
recordRead({
|
||||
actorId: userId,
|
||||
action: 'attachment.read',
|
||||
targetType: 'Attachment',
|
||||
targetId: anhang.id,
|
||||
clearanceAtTime: clearanceLevel,
|
||||
meta: { classification: stufe },
|
||||
})
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,86 @@
|
||||
import { NextResponse } from 'next/server'
|
||||
import { getCurrentUser } from '@/lib/auth/current'
|
||||
import { AccessError } from '@/lib/errors'
|
||||
import { acceptUpload, type AttachmentOwner } from '@/lib/files/service'
|
||||
import { runCheckChain } from '@/lib/files/process'
|
||||
import { MAX_FILE_BYTES } from '@/lib/files/limits'
|
||||
import { de } from '@/lib/i18n/de'
|
||||
|
||||
export const runtime = 'nodejs'
|
||||
export const dynamic = 'force-dynamic'
|
||||
|
||||
/**
|
||||
* Upload.
|
||||
*
|
||||
* Ein Route Handler und keine Server Action: nur so bekommt der Browser einen
|
||||
* Fortschrittsbalken, und 25 MB sind mehr, als eine Server Action annimmt.
|
||||
*
|
||||
* Die Antwort kommt, sobald die Datei in der Quarantäne liegt. Die Prüfkette
|
||||
* läuft danach weiter und meldet sich über `/api/events` — niemand wartet mit
|
||||
* laufendem Balken auf einen Virenscanner. Siehe docs/09.
|
||||
*/
|
||||
export async function POST(request: Request): Promise<Response> {
|
||||
const user = await getCurrentUser()
|
||||
if (!user) return NextResponse.json({ error: 'Nicht angemeldet' }, { status: 401 })
|
||||
|
||||
const laenge = Number(request.headers.get('content-length') ?? 0)
|
||||
if (laenge > MAX_FILE_BYTES * 1.1) {
|
||||
return NextResponse.json({ error: de.attachment.errors['file-too-large'] }, { status: 413 })
|
||||
}
|
||||
|
||||
let form: FormData
|
||||
try {
|
||||
form = await request.formData()
|
||||
} catch {
|
||||
return NextResponse.json({ error: de.actionErrors.default }, { status: 400 })
|
||||
}
|
||||
|
||||
const datei = form.get('file')
|
||||
if (!(datei instanceof File)) {
|
||||
return NextResponse.json({ error: de.actionErrors.default }, { status: 400 })
|
||||
}
|
||||
|
||||
const owner = ownerAusForm(form)
|
||||
if (!owner) return NextResponse.json({ error: de.actionErrors.default }, { status: 400 })
|
||||
|
||||
try {
|
||||
const angelegt = await acceptUpload(user.permissions, {
|
||||
owner,
|
||||
fileName: datei.name || 'unbenannt',
|
||||
declaredType: datei.type || null,
|
||||
content: new Uint8Array(await datei.arrayBuffer()),
|
||||
})
|
||||
|
||||
// Bewusst nicht abgewartet: die Antwort soll sofort raus, damit die
|
||||
// Oberfläche den Anhang mit "Wird geprüft" zeigen kann.
|
||||
void runCheckChain(angelegt.id).catch((error: unknown) => {
|
||||
console.error('[dateien] Prüfkette abgebrochen', error)
|
||||
})
|
||||
|
||||
return NextResponse.json({ id: angelegt.id }, { status: 201 })
|
||||
} catch (error) {
|
||||
if (error instanceof AccessError) {
|
||||
const status = error.code === 'rate-limited' ? 429 : error.code === 'not-found' ? 404 : 400
|
||||
return NextResponse.json(
|
||||
{ error: de.attachment.errors[error.code] ?? de.actionErrors[error.code] ?? de.actionErrors.default },
|
||||
{ status },
|
||||
)
|
||||
}
|
||||
console.error('[dateien] Upload fehlgeschlagen', error)
|
||||
return NextResponse.json({ error: de.actionErrors.default }, { status: 500 })
|
||||
}
|
||||
}
|
||||
|
||||
function ownerAusForm(form: FormData): AttachmentOwner | null {
|
||||
const caseNumber = form.get('caseNumber')
|
||||
if (typeof caseNumber === 'string' && caseNumber) return { kind: 'case', caseNumber }
|
||||
|
||||
const entryId = form.get('entryId')
|
||||
if (typeof entryId === 'string' && entryId) return { kind: 'entry', entryId }
|
||||
|
||||
const documentNumber = form.get('documentNumber')
|
||||
if (typeof documentNumber === 'string' && documentNumber) {
|
||||
return { kind: 'document', documentNumber }
|
||||
}
|
||||
return null
|
||||
}
|
||||
Reference in New Issue
Block a user