💡 Volledig werkend voorbeeld beschikbaar op GitHub:
secure-untrusted-document-upload-conversion-dotnet

De Crediteurenuitdaging: Waarom Leveranciers‑uploadconversie faalt op schaal

Je server converteert de factuur; de HTML van de leverancier bepaalt wat er verder wordt gelezen. Veilige leverancier‑uploadconversie met GroupDocs.Conversion for .NET zet een geüpload bestand om naar PDF zonder dat de eigen referenties van het bestand bepalen wat je server vervolgens ophaalt of leest.

Een leveranciers‑factuurportaal laat elke goedgekeurde leverancier een factuur uploaden – meestal als HTML of PDF, soms met een bijgevoegde SVG‑tekening voor een faciliteiten‑ of bouwonderdeel – en het crediteuren‑systeem converteert deze naar PDF voor archivering en goedkeuringsrouting. De leverancier heeft die HTML geschreven, niet jouw team, en deze kan alles refereren wat een webpagina kan refereren: een stylesheet, een script, een afbeelding gehost op de eigen CDN van de leverancier, of – als het account van de leverancier is gecompromitteerd – een adres dat nooit bereikbaar zou moeten zijn vanuit jouw netwerk.

Het volume van leveranciers groeit alleen maar. Wanneer het van een handvol leveranciers naar honderden gaat, bevat de uploadmap die ooit de bestanden van één bedrijf bewaarde nu die van iedereen – en een relatieve afbeeldingsreferentie in de factuur van één leverancier kan verwijzen naar een bestand dat toebehoort aan een andere leverancier die er direct naast staat.

Wat een crediteuren‑team echt nodig heeft, is geen netwerk‑firewallregel, maar een conversiestap die elke referentie binnen een upload standaard als onbetrouwbaar behandelt, een beoordeeld asset zoals het logo van een leverancier bewust doorlaat, en luid faalt – niet stil – wanneer een whitelist‑item verkeerd is geconfigureerd.

Realiteitscheck: een enkele <img>‑tag die wijst naar http://169.254.169.254/latest/meta-data/iam/security-credentials/ vraagt de converteer‑server om de cloud‑metadata‑service aan te roepen – een verzoek dat de uploader van buiten nooit kan maken. Dat is server‑side request forgery, en een HTML‑upload is alles wat daarvoor nodig is.

Waarom generieke oplossingen deze kloof niet dichten

Crediteuren‑teams grijpen meestal naar een van deze oplossingen voordat ze een conversiebibliotheek met een eigen resource‑beleid adopteren:

  • Netwerk‑egress blokkering op de conversiehost: stopt een externe fetch, maar doet niets aan een bestand in dezelfde map waar een relatieve referentie naar kan verwijzen – precies wat er gebeurt wanneer een upload direct vanuit het opgeslagen pad wordt geconverteerd.
  • Tags strippen vóór conversie: kwetsbaar voor nieuwe referentietypen (<link>, SVG <image>, CSS @import) en moet elke keer opnieuw worden geaudit wanneer het uploadformaat verandert.
  • Vertrouwen op de eigen uploadscanner van het leveranciersportaal: scant op malware‑handtekeningen, niet op een URL die naar jouw eigen infrastructuur wijst.

GroupDocs.Conversion sluit deze kloof op het moment dat er het meest toe doet: het moment dat het document wordt geladen voor conversie, voordat er enige output wordt gegenereerd.

De Oplossing: GroupDocs.Conversion in een Leveranciers‑Factuurworkflow

GroupDocs.Conversion for .NET 26.10 weigert externe resources standaard via SkipExternalResources, laat je precies de locaties opgeven die je vertrouwt via WhitelistedResources, en biedt je een per‑resource callback via IExternalResourceHandler die de resource kan bevestigen, overschrijven of de bytes direct kan leveren – zodat een beoordeeld leverancierslogo nog steeds in de output‑PDF kan verschijnen zonder dat er ooit een netwerkverzoek voor wordt gedaan.

Om de onderstaande implementatie te volgen, heb je nodig:

  • .NET 8.0 of later
  • GroupDocs.Conversion for .NET (een gratis proefversie)
  • Een voorbeeld‑HTML‑ of SVG‑upload die je niet beheert
dotnet add package GroupDocs.Conversion --version 26.10.0

Implementatie van Leveranciers‑Uploadconversie Stap voor Stap

Het onderstaande voorbeeld komt overeen met een realistisch leveranciers‑portalscenario: het converteren van een geüploade factuur (invoice-upload.html) die verwijst naar een logo, een intern adres, een lokaal bestand, en een bestand dat er direct naast staat.

De meeste fragmenten hieronder geven een ResourceAudit‑object door – een kleine IExternalResourceHandler die elke laadbeslissing registreert en de bytes van een vertrouwd asset kan leveren. De volledige code staat in Program.cs van de voorbeeld‑repository.

Stap 1 – Laden en Converteren vanaf het opgeslagen pad van de upload

Zo zou een portaal een upload direct na het opslaan in een gedeelde map kunnen converteren – en de stap waarbij een naastgelegen bestand kan lekken.

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;

Direct laden vanaf uploadPath brengt de volledige map van de factuur in scope, niet alleen het ene bestand erin. Scope, niet vertrouwen, bepaalt wat wordt geladen. In deze run wordt elke externe en file:///‑referentie in de factuur geblokkeerd, maar other-customer-signature.svg – een ander bestand dat in dezelfde map is opgeslagen – wordt geladen, omdat SkipExternalResources alleen referenties buiten die map uitsluit.

Stap 2 – Configureren voor Leveranciers‑Uploadvereisten

Voor leveranciers‑uploads verwijder je de basismap volledig door te laden vanuit een stream in plaats van een pad:

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;

Waarom deze instelling belangrijk is voor leveranciersportalen:

  • Stream‑invoer: een document dat vanuit een stream wordt geconverteerd heeft geen map, zodat een relatieve referentie erin niet kan verwijzen naar een bestand van een andere leverancier.
  • ExternalResourceHandler: blijft draaien voor elke resource, zodat je een nauwkeurig overzicht behoudt van wat elke leveranciers‑upload heeft aangevraagd.

Stap 3 – Uitvoeren en Vastleggen van een Beoordeeld Asset

Een leverancierslogo is een referentie die je mogelijk wilt behouden – geleverd vanuit een kopie die jij beheert, niet opgehaald van de eigen URL van de leverancier:

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;

De handler van ResourceAudit controleert de opgevraagde URL tegen een woordenboek van vertrouwde assets; wanneer deze overeenkomt, stelt hij ExternalResourceLoadingArgs.Data in op lokale bytes en Skipped op false, zodat het logo verschijnt in de output‑PDF terwijl de andere vijf referenties van de factuur geblokkeerd blijven.

Stap 4 – Vroegtijdig afwijzen van een verkeerd geconfigureerde whitelist‑entry

Een whitelist‑item dat alleen een hostnaam is, geen absoluut URI‑prefix, laat de conversie falen in plaats van stilletjes te veel te matchen:

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;
}

Het doorgeven van cdn.example.com in plaats van https://cdn.example.com/brand/ veroorzaakt een InvalidLoadOptionsException met het bericht: 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/'. Het opvangen hiervan op het moment van conversie, tijdens een configuratiereview of een opstartcontrole, is veel goedkoper dan het later te ontdekken door een verkeerd gematchte resource in productie. Vang het op voordat het wordt uitgerold.

Waarom zou een URL‑whitelist‑item ooit worden afgewezen?

WhitelistedResources accepteert alleen absolute URI‑prefixen, zoals https://cdn.example.com/brand/ of file:///C:/assets/. Vroegere versies matchten een item waar het ook maar in de URL voorkwam, dus cdn.example.com matchte ook een adres van een aanvaller dat die woorden slechts bevatte. Sinds 26.10 faalt dat item bij het laden met InvalidLoadOptionsException, en de laatste methode van het voorbeeld print het exacte bericht.

SVG‑bijlagen van Leveranciers Brengen Hetzelfde Risico Met Zich Mee

Een faciliteiten‑tekening die aan een bouwfactuur is toegevoegd, is nog steeds slechts een SVG‑bestand, en deze gaat via SvgLoadOptions in plaats van WebLoadOptions. Zelfde contract, ander element: de ExternalResourceHandler wordt toegepast op zijn <image>‑referenties op dezelfde manier als op de <img>‑tags van de factuur, en elke inline <script> die de tekening bevat, wordt niet uitgevoerd:

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;

Dit is precies het bouw‑factuurscenario uit de inleiding: een tekening die niet meer lijkt dan een plattegrond kan nog steeds een referentie bevatten naar jouw cloud‑metadata‑endpoint, een lokaal bestand, of een server van een aanvaller. In het werkende voorbeeld worden alle drie geblokkeerd, en de bijschrift wordt precies zoals getekend weergegeven, omdat het eraan gekoppelde script nooit wordt uitgevoerd.

Gedrag Voor en Na

Controle Direct converteren vanaf het opgeslagen pad Deze aanpak
Bestand in dezelfde map Wordt automatisch geladen Geblokkeerd – stream‑invoer verwijdert de basismap
Leverancierslogo Geblokkeerd; de PDF toont alleen de alt‑tekst Geleverd vanuit een beoordeeld lokaal bestand
Cloud‑metadata / intern adres Geblokkeerd door de standaard Geblokkeerd door de standaard
Whitelist‑item alleen hostnaam Afgewezen met InvalidLoadOptionsException Op dezelfde manier afgewezen, opgevangen door een opstartcontrole
Inline‑script in de upload Wordt niet uitgevoerd Wordt niet uitgevoerd

Twee rijen veranderen: het logo en het bestand in dezelfde map. Het bestand in dezelfde map is wat een netwerk‑niveau review nooit zou opvangen, omdat er geen netwerkverzoek bij betrokken is.

Andere Leveranciers‑Documentscenario’s Waar Dit Op Van Toepassing Is

Dezelfde ExternalResourceHandler‑eigenschap bestaat op de laadopties voor verschillende andere formaten die leveranciersportalen vaak accepteren, dus het bovenstaande patroon is niet beperkt tot HTML en SVG:

  • Door leveranciers ingediende Word‑ of Excel‑bijlagen: WordProcessingLoadOptions en SpreadsheetLoadOptions bieden hetzelfde handler‑contract.
  • Gemailde facturen: EmailLoadOptions biedt dezelfde handler voor de externe afbeeldingen die een e‑mail‑body referereert.
  • XBRL‑financiële aangiften: FinanceLoadOptions dekt taxonomie‑referenties in door leveranciers ingediende XBRL‑documenten.

Aan de Slag met Jouw Leveranciers‑Uploadpipeline

Je hebt gezien hoe GroupDocs.Conversion onbetrouwbare leveranciers‑uploads veilig afhandelt. Dit is wat je hierna moet doen:

Bronnen