💡 Voll funktionsfähiges Beispiel auf GitHub verfügbar:
secure-untrusted-document-upload-conversion-dotnet
Die Herausforderung im Kreditorenwesen: Warum die Konvertierung von Lieferanten‑Uploads bei Skalierung scheitert
Ihr Server konvertiert die Rechnung; das HTML des Lieferanten entscheidet, was sonst noch gelesen wird. Sichere Lieferanten‑Upload‑Konvertierung mit GroupDocs.Conversion für .NET wandelt eine hochgeladene Datei in PDF um, ohne dass die eigenen Verweise der Datei bestimmen, was Ihr Server als Nächstes abruft oder liest.
Ein Lieferanten‑Rechnungsportal lässt jeden genehmigten Lieferanten eine Rechnung hochladen – meist als HTML oder PDF, manchmal mit einer angehängten SVG‑Zeichnung für einen Anlagen‑ oder Bau‑Posten – und das Kreditoren‑System konvertiert sie zu PDF für Archivierung und Genehmigungs‑Routing. Das HTML wurde vom Lieferanten geschrieben, nicht von Ihrem Team, und es kann alles referenzieren, was eine Webseite referenzieren kann: ein Stylesheet, ein Skript, ein Bild, das im CDN des Lieferanten gehostet wird, oder – falls das Konto des Lieferanten kompromittiert wurde – eine Adresse, die niemals aus Ihrem Netzwerk erreichbar sein sollte.
Das Lieferanten‑Volumen wächst nur. Wenn es von einer Handvoll Lieferanten auf Hunderte ansteigt, enthält der Upload‑Ordner, der einst die Dateien eines Unternehmens hielt, jetzt die aller Lieferanten – und ein relativer Bild‑Verweis in einer Lieferanten‑Rechnung kann zu einer Datei auflösen, die einem anderen Lieferanten gehört und direkt daneben liegt.
Was ein Kreditoren‑Team tatsächlich braucht, ist keine Netzwerk‑Firewall‑Regel, sondern ein Konvertierungsschritt, der jede Referenz in einem Upload standardmäßig als nicht vertrauenswürdig behandelt, ein geprüftes Asset wie das Logo eines Lieferanten bewusst durchlässt und laut – nicht still – fehlschlägt, wenn ein Whitelist‑Eintrag falsch geschrieben ist.
Realitätstest: ein einzelner
<img>‑Tag, der auf
http://169.254.169.254/latest/meta-data/iam/security-credentials/zeigt, veranlasst den konvertierenden Server, den Cloud‑Metadaten‑Dienst aufzurufen – eine Anfrage, die der Uploader von außen niemals stellen könnte. Das ist Server‑Side‑Request‑Forgery, und ein HTML‑Upload reicht dafür aus.
Warum generische Lösungen diese Lücke nicht schließen
Kreditoren‑Teams greifen typischerweise zu einer dieser Maßnahmen, bevor sie eine Konvertierungsbibliothek mit eigener Ressourcen‑Richtlinie einsetzen:
- Netzwerk‑Egress‑Blockierung auf dem Konvertierungs‑Host: stoppt einen Remote‑Abruf, bewirkt aber nichts gegen eine Datei im selben Ordner, zu der ein relativer Verweis auflösen kann – genau das, was passiert, wenn ein Upload direkt von seinem gespeicherten Pfad konvertiert wird.
- Entfernen von Tags vor der Konvertierung: zerbrechlich gegenüber neuen Referenz‑Typen (
<link>, SVG<image>, CSS@import) und muss jedes Mal neu auditiert werden, wenn sich das Upload‑Format ändert. - Vertrauen auf den eigenen Upload‑Scanner des Lieferanten‑Portals: scannt nach Malware‑Signaturen, nicht nach einer URL, die auf Ihre eigene Infrastruktur zeigt.
GroupDocs.Conversion schließt diese Lücke genau dort, wo es am wichtigsten ist: im Moment, in dem das Dokument zum Konvertieren geladen wird, bevor irgendeine Ausgabe erzeugt wird.
Die Lösung: GroupDocs.Conversion in einem Lieferanten‑Rechnungs‑Workflow
GroupDocs.Conversion für .NET 26.10 verweigert externe Ressourcen standardmäßig über SkipExternalResources, lässt Sie exakt die Orte benennen, denen Sie über WhitelistedResources vertrauen, und bietet Ihnen einen pro‑Ressourcen‑Callback über IExternalResourceHandler, der die Bytes einer Ressource bestätigen, überschreiben oder direkt bereitstellen kann – sodass ein geprüftes Lieferanten‑Logo weiterhin im Ausgabe‑PDF erscheint, ohne dass jemals eine Netzwerk‑Anfrage dafür gestellt wird.
Um die nachfolgende Implementierung nachzuvollziehen, benötigen Sie:
- .NET 8.0 oder höher
- GroupDocs.Conversion für .NET (holen Sie sich eine kostenlose Testversion)
- Ein Beispiel‑HTML‑ oder SVG‑Upload, den Sie nicht kontrollieren
dotnet add package GroupDocs.Conversion --version 26.10.0
Implementierung des Lieferanten‑Upload‑Konvertierungsschritts Schritt für Schritt
Das nachstehende Beispiel entspricht einem realen Lieferanten‑Portal‑Szenario: Konvertierung einer hochgeladenen Rechnung (invoice-upload.html), die ein Logo, eine interne Adresse, eine lokale Datei und eine daneben liegende Datei referenziert.
Die meisten Code‑Snippets unten übergeben ein ResourceAudit‑Objekt – einen kleinen IExternalResourceHandler, der jede Lade‑Entscheidung protokolliert und die Bytes eines vertrauenswürdigen Assets bereitstellen kann. Der vollständige Code befindet sich in Program.cs des Beispiel‑Repositories.
Schritt 1 – Laden und Konvertieren vom gespeicherten Pfad des Uploads
So könnte ein Portal einen Upload sofort nach dem Speichern in einen gemeinsamen Ordner konvertieren – und genau hier kann eine Geschwisterdatei eindringen.
var audit = new ResourceAudit();
var loadOptions = new WebLoadOptions { ExternalResourceHandler = audit };
using (var converter = new Converter(uploadPath, (LoadContext _) => loadOptions))
{
converter.Convert(outputPath, new PdfConvertOptions());
}
return audit.Loaded;
Das direkte Laden von uploadPath bringt den gesamten Ordner der Rechnung in den Geltungs‑Bereich, nicht nur die einzelne Datei darin. Der Geltungs‑Bereich, nicht das Vertrauen, entscheidet, was geladen wird. In diesem Durchlauf werden alle Remote‑ und file:///‑Referenzen in der Rechnung blockiert, aber other-customer-signature.svg – eine andere im selben Ordner gespeicherte Datei – wird geladen, weil SkipExternalResources nur Referenzen außerhalb dieses Ordners ausschließt.
Schritt 2 – Konfiguration für Lieferanten‑Upload‑Anforderungen
Für Lieferanten‑Uploads entfernen Sie den Basis‑Ordner vollständig, indem Sie aus einem Stream statt aus einem Pfad laden:
var audit = new ResourceAudit();
var loadOptions = new WebLoadOptions { ExternalResourceHandler = audit };
using (var converter = new Converter(
() => File.OpenRead(uploadPath), (LoadContext _) => loadOptions))
{
converter.Convert(outputPath, new PdfConvertOptions());
}
return audit.Loaded;
Warum diese Einstellung für Lieferanten‑Portale wichtig ist:
- Stream‑Eingabe: Ein Dokument, das aus einem Stream konvertiert wird, hat keinen Ordner, sodass ein relativer Verweis darin nicht zu einer Datei eines anderen Lieferanten auflösen kann.
ExternalResourceHandler: läuft weiterhin für jede Ressource, sodass Sie exakt protokollieren können, was jeder Lieferanten‑Upload angefordert hat.
Schritt 3 – Ausführen und ein geprüftes Asset einbinden
Das Logo eines Lieferanten ist ein Verweis, den Sie möglicherweise behalten wollen – bereitgestellt aus einer Kopie, die Sie kontrollieren, nicht aus der URL des Lieferanten:
var trustedAssets = new Dictionary<string, byte[]>
{
[assetUrl] = File.ReadAllBytes(assetPath)
};
var audit = new ResourceAudit(trustedAssets);
var loadOptions = new WebLoadOptions { ExternalResourceHandler = audit };
using (var converter = new Converter(
() => File.OpenRead(uploadPath), (LoadContext _) => loadOptions))
{
converter.Convert(outputPath, new PdfConvertOptions());
}
return audit.Loaded;
Der Handler von ResourceAudit prüft die angeforderte URL gegen ein Wörterbuch vertrauenswürdiger Assets; trifft ein Treffer, setzt er ExternalResourceLoadingArgs.Data auf lokale Bytes und Skipped auf false, sodass das Logo im Ausgabe‑PDF erscheint, während die anderen fünf Referenzen der Rechnung blockiert bleiben.
Schritt 4 – Frühes Ablehnen eines fehlerhaft konfigurierten Whitelist‑Eintrags
Ein Whitelist‑Eintrag, der nur ein Host‑Name ist und kein absoluter URI‑Präfix, lässt die Konvertierung fehlschlagen, anstatt still zu viel zuzulassen:
var loadOptions = new WebLoadOptions
{
WhitelistedResources = new List<string> { entry }
};
try
{
using var converter = new Converter(
() => File.OpenRead(uploadPath), (LoadContext _) => loadOptions);
converter.Convert(outputPath, new PdfConvertOptions());
return null;
}
catch (InvalidLoadOptionsException exception)
{
return exception.Message;
}
Wird cdn.example.com anstelle von https://cdn.example.com/brand/ übergeben, wirft das InvalidLoadOptionsException mit der Meldung: Whitelisted resource 'cdn.example.com' is not valid. Expected an absolute URI prefix without a query, fragment or encoded '/', '\' or '.', such as 'https://cdn.example.com/assets/' or 'file:///C:/assets/'. Dieses Problem bereits zur Konvertierungszeit, bei einer Konfigurations‑Überprüfung oder einem Start‑Check zu erfassen, ist weitaus günstiger, als es später in der Produktion durch eine falsch gematchte Ressource zu entdecken. Fangen Sie es ab, bevor es ausgeliefert wird.
Warum könnte ein URL‑Whitelist‑Eintrag jemals abgelehnt werden?
WhitelistedResources akzeptiert nur absolute URI‑Präfixe, wie https://cdn.example.com/brand/ oder file:///C:/assets/. Frühere Versionen haben einen Eintrag überall dort gematcht, wo er in der URL vorkam, sodass cdn.example.com auch die Adresse eines Angreifers traf, die lediglich diese Wörter enthielt. Seit 26.10 schlägt dieser Eintrag mit InvalidLoadOptionsException fehl, und die letzte Methode des Beispiels gibt die genaue Meldung aus.
Lieferanten‑SVG‑Anhänge bergen das gleiche Risiko
Eine Anlagen‑Zeichnung, die einer Bau‑Rechnung beigefügt ist, bleibt dennoch nur eine SVG‑Datei und wird über SvgLoadOptions statt WebLoadOptions verarbeitet. Derselbe Vertrag, ein anderes Element: Der ExternalResourceHandler gilt für deren <image>‑Referenzen genauso wie für die <img>‑Tags der Rechnung, und jedes Inline‑<script> in der Zeichnung wird nicht ausgeführt:
var audit = new ResourceAudit();
var loadOptions = new SvgLoadOptions { ExternalResourceHandler = audit };
using (var converter = new Converter(
() => File.OpenRead(uploadPath), (LoadContext _) => loadOptions))
{
converter.Convert(outputPath, new PdfConvertOptions());
}
return audit.Loaded;
Das ist exakt das Bau‑Rechnungs‑Szenario aus der Einleitung: Eine Zeichnung, die wie ein einfacher Grundriss aussieht, kann dennoch eine Referenz zu Ihrem Cloud‑Metadaten‑Endpunkt, einer lokalen Datei oder dem Server eines Angreifers enthalten. Im funktionierenden Beispiel werden alle drei blockiert, und die Beschriftung wird exakt wie gezeichnet dargestellt, weil das angehängte Skript niemals ausgeführt wird.
Verhalten vorher und nachher
| Prüfung | Direktes Konvertieren vom gespeicherten Pfad | Dieser Ansatz |
|---|---|---|
| Gleiches Ordner‑Geschwisterdatei | Wird automatisch geladen | Blockiert – Stream‑Eingabe entfernt den Basisordner |
| Lieferantenlogo | Blockiert; das PDF zeigt nur den Alt‑Text | Aus einer geprüften lokalen Datei bereitgestellt |
| Cloud‑Metadaten / interne Adresse | Durch die Standardeinstellung blockiert | Durch die Standardeinstellung blockiert |
| Whitelist‑Eintrag nur mit Hostnamen | Abgelehnt mit InvalidLoadOptionsException |
Auf dieselbe Weise abgelehnt, von einem Start‑Check erfasst |
| Inline‑Skript im Upload | Wird nicht ausgeführt | Wird nicht ausgeführt |
Zwei Zeilen ändern sich: das Logo und die Geschwisterdatei. Die Geschwisterdatei ist das, was ein Netzwerk‑Review niemals erfassen würde, weil keine Netzwerk‑Anfrage involviert ist.
Weitere Lieferanten‑Dokument‑Szenarien, bei denen das gilt
Die gleiche ExternalResourceHandler‑Eigenschaft existiert in den Lade‑Optionen für mehrere andere Formate, die Lieferanten‑Portale häufig akzeptieren, sodass das obige Muster nicht auf HTML und SVG beschränkt ist:
- Vom Lieferanten eingereichte Word‑ oder Excel‑Anhänge:
WordProcessingLoadOptionsundSpreadsheetLoadOptionsstellen denselben Handler‑Vertrag bereit. - Per E‑Mail gesendete Rechnungen:
EmailLoadOptionsstellt denselben Handler für die Remote‑Bilder bereit, die im E‑Mail‑Body referenziert werden. - XBRL‑Finanzberichte:
FinanceLoadOptionsdeckt Taxonomie‑Referenzen in vom Lieferanten eingereichten XBRL‑Dokumenten ab.
Erste Schritte mit Ihrer Lieferanten‑Upload‑Pipeline
Sie haben gesehen, wie GroupDocs.Conversion untrusted Lieferanten‑Uploads sicher verarbeitet. So geht es weiter:
- Kostenlos starten: temporäre Lizenz erhalten zum Entfernen der Evaluations‑Limits
- Die vollständige Ressourcen‑Richtlinie lesen: skip loading of external resources behandelt
WhitelistedResources,IExternalResourceHandlerund Skript‑Handling im Detail - Prüfen, was überhaupt das Netzwerk berührt: network access and data privacy
- Der Schritt‑für‑Schritt‑Anleitung folgen: convert untrusted uploads safely - use case
- Das funktionierende Beispiel durchsuchen: secure-untrusted-document-upload-conversion-dotnet on GitHub