In einer Webanwendung ist der Datei-Upload der Punkt, an dem der Benutzer mit der größten Kontrolle Daten auf dem Server ablegt: Inhalt, Name, Größe und Typ kommen vom Benutzer. Ein harmloses Feld für Rechnungsanhang, Lebenslauf, technische Zeichnung oder Profilfoto öffnet bei falscher Umsetzung die Tür zu Remote Code Execution, voller Festplatte oder der Auslieferung schädlicher Inhalte an andere Benutzer. Eine im Verzeichnis uploads/ des Web-Roots ausgeführte .php-Datei ist bei Vorfallsanalysen noch immer eine der häufigsten Spuren. Im Folgenden beschreiben wir Risiken und mehrschichtige Maßnahmen mit Konfigurationsbeispielen, von der Typprüfung über die Speicherung und signierte URLs bis zum Scan und zur sicheren Auslieferung. Die Wirkung von Datei- und Verbindungskontrollen in der Produktionsumgebung können Sie mit einem unabhängigen Sicherheitsaudit für Webanwendungen untersuchen.
Die Risikofläche des Datei-Uploads
Die Klassifizierung der Risiken macht klar, welche Maßnahme gegen welche Bedrohung gerichtet ist, und widerlegt den Irrtum „Wir haben die Endung geprüft, das genügt“:
| Risiko | Wie entsteht es? | Grundlegende Maßnahme |
|---|---|---|
| Codeausführung auf dem Server | Eine Datei wie .php oder .jsp landet im Web-Root in einem ausführbaren Verzeichnis |
Speicherung außerhalb des Web-Roots, Ausführung deaktivieren |
| Path Traversal / Überschreiben | Dateiname enthält ../../ oder kollidiert mit einer vorhandenen Datei |
Serverseitig erzeugter Name |
| Fälschung des Inhaltstyps | Endung und Header Content-Type werden im Client geändert |
Typerkennung aus dem Inhalt (Magic Bytes) |
| Schädliche Inhalte für Benutzer | Skript in HTML/SVG wird vom selben Ursprung ausgeliefert (Stored XSS) | Separate Domain, attachment, nosniff |
| Ressourcenverbrauch (DoS) | Sehr große Dateien, sehr viele Uploads, Kompressionsbombe | Größen-, Anzahl- und Ratenlimits |
| Verbreitung von Schadsoftware | Die hochgeladene Datei wird von anderen Benutzern heruntergeladen | Scan und Quarantäne |
Keine dieser Maßnahmen genügt allein. Sie werden übereinandergelegt, damit die dahinterliegende greift, wenn eine umgangen wird. Umfassende Referenz zum Thema ist das OWASP File Upload Cheat Sheet.
Ebenen der Dateitypprüfung
Bei der Typprüfung wird eine Allowlist verwendet: Die nach Geschäftsbedarf zugelassenen Typen werden explizit aufgezählt. Eine Liste verbotener Endungen (Blocklist) bleibt immer unvollständig; Varianten wie .phtml, .php5, .phar oder andere, von der Serverkonfiguration abhängige Endungen werden übersehen. Eine Blacklist wird eines Tages garantiert durchbrochen.
- Endung: Die letzte Endung des Dateinamens wird in Kleinbuchstaben umgewandelt und mit der Allowlist verglichen. Doppelte Endungen wie
rechnung.pdf.phpund Tricks wie Punkt oder Leerzeichen am Ende werden in diesem Schritt aussortiert. - Vom Client gemeldeter MIME-Typ: Den Header
Content-Typebestimmt der Client und ändert ihn leicht; er dient nur zur ersten Aussortierung. - Inhaltssignatur (Magic Bytes): Die ersten Bytes der Datei zeigen das tatsächliche Format. Sind Endung, gemeldeter Typ und Inhaltssignatur nicht konsistent, wird die Datei abgelehnt.
- Strukturelle Validierung oder Neuverarbeitung: Werden Bilder mit einer Bildbibliothek geöffnet und neu kodiert (z. B. erneut als JPEG gespeichert), werden darin versteckte Zusatzdaten und Metadaten (einschließlich Standortangaben in EXIF) entfernt.
Signaturen verbreiteter Formate:
| Format | Erste Bytes (hex) | Hinweis |
|---|---|---|
25 50 44 46 2D (%PDF-) |
PDF kann JavaScript und eingebettete Dateien enthalten | |
| PNG | 89 50 4E 47 0D 0A 1A 0A |
Neukodierung empfohlen |
| JPEG | FF D8 FF |
EXIF-Metadaten sollten entfernt werden |
| ZIP / DOCX / XLSX | 50 4B 03 04 |
Office-Dokumente sind ZIP-Container; Typen mit Makros sind gesondert zu bewerten |
// Node.js: Konsistenz von Endung + Inhaltssignatur (Allowlist)
import { extname } from 'node:path';
const ERLAUBT = {
'.pdf': [[0x25, 0x50, 0x44, 0x46, 0x2d]],
'.png': [[0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]],
'.jpg': [[0xff, 0xd8, 0xff]],
'.jpeg': [[0xff, 0xd8, 0xff]],
} as const;
export function typPruefen(dateiname: string, kopf: Uint8Array): boolean {
const endung = extname(dateiname).toLowerCase() as keyof typeof ERLAUBT;
const signaturen = ERLAUBT[endung];
if (!signaturen) return false; // nicht in der Allowlist
return signaturen.some((sig) => sig.every((b, i) => kopf[i] === b));
}
SVG verlangt besondere Aufmerksamkeit: Es ist XML-basiert und kann <script> sowie Event-Attribute enthalten. Nehmen Sie ohne Geschäftsbedarf kein SVG an; ist es nötig, führen Sie es serverseitig durch eine Bereinigungsbibliothek oder wandeln es in ein Rasterformat wie PNG um. Auch HTML-Dateien werden nicht als Benutzerinhalt akzeptiert.
Bei einer Anwendung hinter Nginx wird das Limit für den Anfrage-Body mit client_max_body_size festgelegt; wird es überschritten, liefert Nginx 413, und die Anfrage erreicht die Anwendung gar nicht. Geben Sie dem Upload-Endpunkt ein großzügiges, anderen Endpunkten ein enges Limit. Ruft ein Benutzer an, weil „die Datei nicht hochlädt“, ist dies auch die erste Stelle zum Nachsehen: die Zeile „client intended to send too large body“ im Nginx-Error-Log. Weitere Details zur Reverse-Proxy-Konfiguration im Leitfaden Nginx-Reverse-Proxy-Konfiguration.
server {
client_max_body_size 1m; # allgemeiner Standard
location /api/dokumente/hochladen {
client_max_body_size 20m; # nur Upload-Endpunkt
proxy_pass http://app_backend;
}
}
Speicherort und Benennung
Eine hochgeladene Datei wird nicht in ein Verzeichnis geschrieben, das der Webserver direkt als Datei ausliefert. Sichere Optionen sind ein Verzeichnis außerhalb des Web-Roots oder Objektspeicher (S3-kompatibler Speicher, Azure Blob Storage); Dateien werden über die Anwendung mit Berechtigungsprüfung ausgeliefert. Müssen Dateien in einer alten Anwendung im Web-Root bleiben, deaktivieren Sie in diesem Verzeichnis die Skriptausführung:
# Nginx: PHP-Ausfuehrung im Upload-Verzeichnis verhindern
location ^~ /uploads/ {
location ~* \.(php|phtml|phar)$ { return 403; }
add_header X-Content-Type-Options nosniff always;
}
Übernehmen Sie den Dateinamen nicht vom Benutzer. Der Server erzeugt eine zufällige Kennung (UUID) und speichert die Datei unter dieser Kennung; der Originalname wird nur als Metadatum in der Datenbank gehalten und beim Download bereinigt im Header Content-Disposition verwendet. Path Traversal, Namenskollisionen und Informationsabfluss über den Dateinamen sind damit gleichzeitig geschlossen. Der Datenbankeintrag sollte Eigentümer der Datei, zugehörigen Geschäftsdatensatz, Größe, erkannten Typ, Hashwert (SHA-256) und Scanstatus enthalten.
In individuellen Geschäftsanwendungen erfolgt die Zugriffskontrolle nicht auf Datei-, sondern auf Ebene des zugehörigen Datensatzes: Hat der Benutzer Zugriff auf einen Beschaffungsantrag, hat er auch Zugriff auf dessen Anhänge. Verwenden Sie keine vorhersagbaren fortlaufenden IDs (/datei/1043); müssen Sie es doch, prüfen Sie die Berechtigung bei jeder Anfrage. Andernfalls entsteht eine IDOR-Lücke (unsichere direkte Objektreferenz), und jeder, der die Zahl in der Adressleiste um eins erhöht, lädt die Rechnung eines anderen herunter.
Direkter Upload per signierter URL
Laufen große Dateien über den Anwendungsserver, entstehen Probleme mit Speicher, Bandbreite und Timeouts. Wird Objektspeicher verwendet, ist das bessere Muster, dass der Client die Datei direkt in den Speicher hochlädt. Der Ablauf:
- Der Client fordert bei der Anwendung mit Dateiname, Größe und Typ eine Upload-Berechtigung an.
- Die Anwendung prüft die Berechtigung des Benutzers und die gemeldeten Metadaten, erzeugt einen zufälligen Objektschlüssel, legt den Datensatz im Status „ausstehend“ an und gibt eine kurzlebige signierte URL zurück.
- Der Client lädt die Datei direkt zu dieser URL hoch.
- Nach Abschluss des Uploads (per Client-Meldung oder Ereignisbenachrichtigung des Speichers) validiert ein serverseitiger Handler das Objekt, scannt es und aktualisiert den Status.
// AWS SDK v3: signierter POST mit durchsetzbarer Groessenbegrenzung
import { S3Client } from '@aws-sdk/client-s3';
import { createPresignedPost } from '@aws-sdk/s3-presigned-post';
import { randomUUID } from 'node:crypto';
const s3 = new S3Client({ region: 'eu-central-1' });
export async function uploadBerechtigung(benutzerId: string) {
const key = `quarantaene/${benutzerId}/${randomUUID()}`;
return createPresignedPost(s3, {
Bucket: 'unternehmen-dokumente',
Key: key,
Conditions: [
['content-length-range', 1, 20 * 1024 * 1024], // 1 Byte – 20 MB
['eq', '$Content-Type', 'application/pdf'],
],
Fields: { 'Content-Type': 'application/pdf' },
Expires: 300, // Sekunden
});
}
Eine signierte PUT-URL (getSignedUrl mit PutObjectCommand) ist einfacher, kann in S3 aber den erlaubten Größenbereich nicht als Policy-Bedingung definieren. Ist die Größenbegrenzung wichtig, wählen Sie signierten POST und die Bedingung content-length-range. In beiden Fällen sind vom Client gemeldeter Typ und Größe nur eine Vorprüfung; die Datei landet im Quarantäne-Präfix und wird niemandem ausgeliefert, bevor sie die serverseitige Validierung und den Scan durchlaufen hat. Der Bucket ist nicht öffentlich; auch das Lesen erfolgt über kurzlebige signierte URLs. Der Konfigurationsfehler, den wir in der Praxis am häufigsten sehen, ist ein während des Tests „vorübergehend“ geöffneter öffentlicher Zugriff, der im Bucket vergessen wurde.
Malware-Scan und Quarantäne
Dateien, die andere Benutzer herunterladen oder die in interne Systeme übertragen werden, durchlaufen einen Malware-Scan. Die Open-Source-Option ist ClamAV; der Dienst clamd wird laufend gehalten, und Dateien werden über clamdscan oder den Dienst-Socket gescannt. Bei Cloud-Speicher kommen auch eigene Scandienste der Anbieter in Betracht.
# ClamAV-Signaturupdate und Scan einer einzelnen Datei
sudo freshclam
clamdscan --fdpass --no-summary /var/app/quarantaene/3f2a9c1e-...
# Exit-Code: 0 = sauber, 1 = Schadsoftware gefunden, 2 = Fehler
Entwerfen Sie den Quarantäneablauf als Zustandsautomat: ausstehend → wird_gescannt → sauber | schaedlich | fehler. Nur Dateien im Status sauber können heruntergeladen oder in den Workflow übernommen werden. Ein Scanfehler gilt nicht als „sauber“. Er wird erneut versucht und bei dauerhaftem Fehler an das Betriebsteam gemeldet. Ist das Signaturupdate (freshclam) zum Stillstand gekommen, scheint der Scan zu laufen, scannt aber mit alten Signaturen; überwachen Sie den Zeitpunkt des Updates. Da der Scan signaturbasiert ist, kann er neue Schadsoftware übersehen und ersetzt daher weder Typbeschränkung noch Neuverarbeitung noch sichere Auslieferung. Passwortgeschützte Archive lassen sich nicht scannen; lehnen Sie sie ohne Geschäftsbedarf ab, und begrenzen Sie bei Annahme von Archiven die entpackte Gesamtgröße und Dateianzahl als Schutz vor Kompressionsbomben.
Sichere Auslieferungsheader und Checkliste
Selbst wenn eine Datei sicher angenommen und gespeichert wird, kann der Browser sie bei falschen Headern ausführen. Empfohlene Header für Benutzerinhalte:
Content-Type: application/pdf # erkannter tatsaechlicher Typ
Content-Disposition: attachment; filename="rechnung-beispiel.pdf"; filename*=UTF-8''rechnung-%C3%BCbersicht.pdf
X-Content-Type-Options: nosniff
Content-Security-Policy: sandbox; default-src 'none'
Cache-Control: private, no-store
attachment sorgt dafür, dass die Datei heruntergeladen statt im Browser geöffnet wird; ist eine Inline-Anzeige nötig (Bildvorschau), verwenden Sie inline nur bei Typen, die als sicher bekannt sind. nosniff verhindert, dass der Browser den Typ per Content Sniffing ändert. Der Parameter filename* ist die Form, die RFC 6266 auf Basis der Kodierung aus RFC 8187 definiert und die Nicht-ASCII-Zeichen transportiert; für ältere Clients wird zusätzlich das einfache filename gesendet. Benutzerinhalte von einer von der Hauptanwendung getrennten Domain auszuliefern, verhindert, dass eine mögliche Skriptausführung auf die Sitzungscookies der Anwendung zugreift. Stellen Sie bei Dateien mit personenbezogenen Daten die Cache-Header bewusst ein, damit gemeinsame Caches die Antwort nicht speichern; Details im Leitfaden Cache-Control- und CDN-Header.
Checkliste
- Zugelassene Typen sind nach Geschäftsbedarf per Allowlist definiert; SVG, HTML und ausführbare Typen sind ausgeschlossen.
- Endung, gemeldeter MIME-Typ und Inhaltssignatur werden auf dem Server gemeinsam geprüft; Bilder werden neu kodiert.
- Größenlimits sind im Reverse Proxy, in der Anwendung und (falls vorhanden) in der Bedingung des signierten Uploads definiert; es gibt Raten- und Anzahllimits pro Benutzer.
- Dateinamen werden auf dem Server erzeugt; der Originalname ist nur ein Metadatum.
- Dateien liegen außerhalb des Web-Roots oder in privatem Objektspeicher; Skriptausführung im Upload-Verzeichnis ist deaktiviert.
- Bei jeder Download-Anfrage wird die Berechtigung für den zugehörigen Datensatz geprüft.
- Es gibt einen Quarantäne- und Scanablauf; nur saubere Dateien werden ausgeliefert, die Aktualität der Signaturen wird überwacht.
- Bei der Auslieferung werden
attachment,nosniffund eine restriktive CSP verwendet; vorzugsweise eine separate Domain. - Upload-, Ablehnungs- und Scanergebnisse werden protokolliert.
Um das Upload-Feld an denselben Validierungsvertrag wie den Rest des Formulars zu binden, ergänzt der Leitfaden Formularvalidierung mit einem einzigen Schema verwalten diesen Beitrag. Um die Upload-Funktionen einer bestehenden Anwendung zu überprüfen oder zusätzliche Regeln in der WAF-Schicht zu definieren, führen wir Prüfungen im Rahmen von Webanwendungssicherheit und WAF durch.
Häufig gestellte Fragen
Genügt es, die Dateiendung zu prüfen?
Nein. Endung und vom Client gemeldeter Inhaltstyp lassen sich leicht ändern. Endungs-Allowlist, Prüfung der Inhaltssignatur, serverseitig erzeugter Dateiname, nicht ausführbarer Speicherort und sichere Auslieferungsheader müssen gemeinsam angewendet werden.
Sollten hochgeladene Dateien in der Datenbank gespeichert werden?
In der Regel nicht. Die Datei selbst liegt in einem Verzeichnis außerhalb des Web-Roots oder in privatem Objektspeicher, ihre Metadaten in der Datenbank. Diese Trennung hält Datenbankgröße und Sicherungsdauer unter Kontrolle.
Wie wird die Dateigröße beim Upload über eine signierte URL begrenzt?
Bei S3-kompatiblem Speicher lässt sich die maximale Größe speicherseitig erzwingen, indem der signierten POST-Policy die Bedingung content-length-range hinzugefügt wird. Bei einer signierten PUT-URL gibt es keine solche Bereichsbedingung, sodass die Größenprüfung weitgehend der Validierung nach dem Upload überlassen bleibt.
Ersetzt ein Virenscan die anderen Maßnahmen?
Nein. Signaturbasierter Scan erkennt bekannte Schadsoftware, kann neue oder speziell präparierte Dateien aber übersehen. Der Scan wird als eine Schicht zusammen mit Typbeschränkung, Neuverarbeitung, Berechtigungsprüfung und sicheren Auslieferungsheadern eingesetzt.