Sicherer Datei-Upload in Webanwendungen: Validierung, Speicherung, Scan

Sicherer Datei-Upload: Typprüfung per Allowlist und Magic Bytes, Speicherung außerhalb des Web-Roots, signierte URLs, Quarantäne mit ClamAV und sichere Auslieferungsheader.
Technische Zusammenfassung
Technologie
OWASP, Nginx, Node.js, AWS S3 presigned POST, ClamAV, HTTP-Sicherheitsheader
Thema
Datei-Upload-Funktion in Webanwendungen sicher entwickeln
Niveau
Mittel bis fortgeschritten
Voraussetzungen
  • Kenntnisse zu HTTP-Anfrage-/Antwortstruktur und Headern
  • Erfahrung in serverseitiger Webentwicklung
In diesem Beitrag7 Abschnitte

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.

  1. Endung: Die letzte Endung des Dateinamens wird in Kleinbuchstaben umgewandelt und mit der Allowlist verglichen. Doppelte Endungen wie rechnung.pdf.php und Tricks wie Punkt oder Leerzeichen am Ende werden in diesem Schritt aussortiert.
  2. Vom Client gemeldeter MIME-Typ: Den Header Content-Type bestimmt der Client und ändert ihn leicht; er dient nur zur ersten Aussortierung.
  3. 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.
  4. 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
PDF 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:

  1. Der Client fordert bei der Anwendung mit Dateiname, Größe und Typ eine Upload-Berechtigung an.
  2. 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.
  3. Der Client lädt die Datei direkt zu dieser URL hoch.
  4. 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, nosniff und 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.

Support

Kontaktieren Sie uns für Support oder eine Bestandsaufnahme zu diesem Thema.

Kontaktformular
[email protected]

Eretek Web

Wir bauen Unternehmenswebsites, WordPress- und CMS-Plattformen, Intranet- und SharePoint-Portale, Dokumentenmanagement sowie Formular- und Freigabeprozesse auf und halten sie sicher und aktuell.

Wissenszentrum

Weitere Beiträge