💡 Esempio completo funzionante disponibile su GitHub: secure-untrusted-document-upload-conversion-dotnet
La sfida della contabilità fornitori: perché la conversione di caricamenti dei fornitori fallisce su larga scala
Il tuo server converte la fattura; l’HTML del fornitore decide cos’altro legge. Una conversione sicura di caricamenti dei fornitori con GroupDocs.Conversion per .NET trasforma un file caricato in PDF senza consentire ai riferimenti del file stesso di scegliere cosa il tuo server recupera o legge successivamente.
Un portale di fatturazione dei fornitori consente a qualsiasi fornitore approvato di caricare una fattura – solitamente in HTML o PDF, a volte con un disegno SVG allegato per una voce di impianto o costruzione – e il sistema di contabilità fornitori lo converte in PDF per l’archiviazione e il flusso di approvazione. Il fornitore ha scritto quell’HTML, non il tuo team, e può fare riferimento a qualsiasi cosa a cui una pagina web può fare riferimento: un foglio di stile, uno script, un’immagine ospitata sul CDN del fornitore, o – se l’account del fornitore è stato compromesso – un indirizzo che non era mai destinato a essere raggiungibile dalla tua rete.
Il volume dei fornitori cresce costantemente. Quando passa da una manciata di fornitori a centinaia, la cartella degli upload che una volta conteneva i file di un’unica azienda ora contiene quelli di tutti – e un riferimento immagine relativo all’interno della fattura di un fornitore può risolversi a un file appartenente a un altro fornitore che si trova proprio accanto.
Ciò di cui un team di contabilità fornitori ha realmente bisogno non è una regola firewall di rete, ma un passaggio di conversione che tratti ogni riferimento all’interno di un upload come non attendibile per impostazione predefinita, consenta deliberatamente il passaggio di un asset revisionato come il logo di un fornitore, e fallisca in modo evidente – non silenzioso – quando una voce della whitelist è scritta in modo errato.
Verifica della realtà: un singolo tag
<img>puntato ahttp://169.254.169.254/latest/meta-data/iam/security-credentials/chiede al server di conversione di chiamare il servizio di metadati del cloud – una richiesta che chi carica non potrebbe mai fare dall’esterno. Si tratta di una falsificazione di richieste lato server, e basta un upload HTML per realizzarla.
Perché le soluzioni generiche non colmano questa lacuna
I team di contabilità fornitori tipicamente ricorrono a una di queste soluzioni prima di adottare una libreria di conversione con la propria politica delle risorse:
- Blocco dell’uscita di rete sull’host di conversione: interrompe un recupero remoto, ma non fa nulla per un file nella stessa cartella a cui un riferimento relativo può risolversi – esattamente ciò che accade quando un upload viene convertito direttamente dal suo percorso salvato.
- Rimozione dei tag prima della conversione: fragile rispetto a nuovi tipi di riferimento (
<link>, SVG<image>, CSS@import) e richiede una nuova revisione ogni volta che il formato dell’upload cambia. - Fidarsi dello scanner di upload del portale del fornitore: esegue scansioni per firme di malware, non per un URL che punta alla tua infrastruttura.
GroupDocs.Conversion colma questa lacuna nel punto più critico: nel momento in cui il documento viene caricato per la conversione, prima che venga prodotto qualsiasi output.
La soluzione: GroupDocs.Conversion in un flusso di lavoro di fatturazione fornitori
GroupDocs.Conversion per .NET 26.10 nega le risorse esterne per impostazione predefinita tramite SkipExternalResources, consente di specificare esattamente le posizioni di cui ti fidi tramite WhitelistedResources, e fornisce un callback per risorsa tramite IExternalResourceHandler che può confermare, sovrascrivere o fornire direttamente i byte della risorsa – così un logo di fornitore revisionato può comunque apparire nel PDF di output senza che venga effettuata alcuna richiesta di rete.
Per seguire l’implementazione di seguito, avrai bisogno di:
- .NET 8.0 o successivo
- GroupDocs.Conversion per .NET (ottieni una prova gratuita)
- Un upload di esempio HTML o SVG che non controlli
dotnet add package GroupDocs.Conversion --version 26.10.0
Implementare la conversione di upload dei fornitori passo dopo passo
L’esempio seguente corrisponde a uno scenario reale di portale fornitori: conversione di una fattura caricata (invoice-upload.html) che fa riferimento a un logo, a un indirizzo interno, a un file locale e a un file adiacente.
La maggior parte degli snippet qui sotto passa un oggetto ResourceAudit – un piccolo IExternalResourceHandler che registra ogni decisione di caricamento e può fornire i byte di un asset attendibile. Il suo codice completo si trova in Program.cs del repository di esempio.
Passo 1 – Caricare e convertire dal percorso salvato dell’upload
Ecco come un portale potrebbe convertire un upload subito dopo averlo salvato in una cartella condivisa – e il passaggio in cui un file fratello può infiltrarsi.
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;
Caricare direttamente da uploadPath mette l’intera cartella della fattura a disposizione, non solo il singolo file al suo interno. È la portata, non la fiducia, a decidere cosa viene caricato. In questa esecuzione, ogni riferimento remoto e file:/// nella fattura è bloccato, ma other-customer-signature.svg – un file diverso salvato nella stessa cartella – viene caricato, perché SkipExternalResources esclude solo i riferimenti al di fuori di quella cartella.
Passo 2 – Configurare per i requisiti di upload dei fornitori
Per gli upload dei fornitori, rimuovi completamente la cartella di base caricando da uno stream invece che da un percorso:
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;
Perché questa impostazione è importante per i portali dei fornitori:
- Input stream: un documento convertito da uno stream non ha cartella, quindi un riferimento relativo al suo interno non può risolversi a un file di un altro fornitore.
ExternalResourceHandler: continua a funzionare per ogni risorsa, così mantieni un registro esatto di ciò che ogni upload del fornitore ha richiesto.
Passo 3 – Eseguire e catturare un asset revisionato
Il logo di un fornitore è un riferimento che potresti effettivamente voler mantenere – fornito da una copia che controlli, non recuperato dall’URL del fornitore:
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;
Il gestore di ResourceAudit verifica l’URL richiesto rispetto a un dizionario di asset attendibili; quando corrisponde, imposta ExternalResourceLoadingArgs.Data sui byte locali e Skipped su false, così il logo appare nel PDF di output mentre gli altri cinque riferimenti della fattura rimangono bloccati.
Passo 4 – Rifiutare in anticipo una voce di whitelist mal configurata
Una voce di whitelist che è solo un nome host, non un prefisso URI assoluto, fa fallire la conversione invece di corrispondere silenziosamente a troppo:
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;
}
Passare cdn.example.com invece di https://cdn.example.com/brand/ genera InvalidLoadOptionsException con il messaggio: 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/'. Catturare questo al momento della conversione, in una revisione di configurazione o in un controllo all’avvio, è molto più economico che scoprirlo da una risorsa erroneamente corrispondente in produzione. Catturalo prima che venga distribuito.
Perché una voce di whitelist URL potrebbe mai essere rifiutata?
WhitelistedResources accetta solo prefissi URI assoluti, come https://cdn.example.com/brand/ o file:///C:/assets/. Le versioni precedenti corrispondevano a una voce ovunque apparisse nell’URL, quindi cdn.example.com corrispondeva anche a un indirizzo di un attaccante che conteneva semplicemente quelle parole. Dalla versione 26.10 quella voce fa fallire il caricamento con InvalidLoadOptionsException, e l’ultimo metodo del campione stampa il messaggio esatto.
Gli allegati SVG dei fornitori comportano lo stesso rischio
Un disegno di impianto allegato a una fattura di costruzione è comunque solo un file SVG, e passa attraverso SvgLoadOptions invece di WebLoadOptions. Stesso contratto, elemento diverso: l’ExternalResourceHandler si applica ai suoi riferimenti <image> come faceva ai tag <img> della fattura, e qualsiasi <script> inline contenuto nel disegno non viene eseguito:
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;
Questo è esattamente lo scenario della fattura di costruzione introdotto all’inizio: un disegno che sembra solo una pianta può comunque contenere un riferimento al tuo endpoint di metadati cloud, a un file locale o al server di un attaccante. Nel campione funzionante tutti e tre sono bloccati, e la didascalia viene resa esattamente come disegnata, perché lo script allegato non viene mai eseguito.
Comportamento prima e dopo
| Verifica | Conversione direttamente dal percorso salvato | Questo approccio |
|---|---|---|
| File fratello nella stessa cartella | Caricato automaticamente | Bloccato – l’input stream rimuove la cartella di base |
| Logo del fornitore | Bloccato; il PDF mostra solo il testo alternativo | Fornito da un file locale revisionato |
| Metadati cloud / indirizzo interno | Bloccato per impostazione predefinita | Bloccato per impostazione predefinita |
| Voce whitelist solo nome host | Rifiutata con InvalidLoadOptionsException |
Rifiutata allo stesso modo, catturata da un controllo all’avvio |
| Script inline nell’upload | Non viene eseguito | Non viene eseguito |
Due righe cambiano: il logo e il file fratello. Il file fratello è quello che una revisione a livello di rete non catturerebbe mai, perché non è coinvolta alcuna richiesta di rete.
Altri scenari di documenti fornitori a cui questo si applica
La stessa proprietà ExternalResourceHandler esiste nelle opzioni di caricamento per diversi altri formati comunemente accettati dai portali fornitori, quindi il modello sopra non è limitato a HTML e SVG:
- Allegati Word o Excel inviati dal fornitore:
WordProcessingLoadOptionseSpreadsheetLoadOptionsespongono lo stesso contratto del gestore. - Fatture inviate via e‑mail:
EmailLoadOptionsespone lo stesso gestore per le immagini remote a cui fa riferimento il corpo dell’e‑mail. - Dichiarazioni finanziarie XBRL:
FinanceLoadOptionscopre i riferimenti di tassonomia nei documenti XBRL inviati dal fornitore.
Iniziare con il tuo flusso di upload dei fornitori
Hai visto come GroupDocs.Conversion gestisce in modo sicuro gli upload non attendibili dei fornitori. Ecco cosa fare dopo:
- Inizia gratuitamente: ottieni una licenza temporanea per rimuovere i limiti di valutazione
- Leggi l’intera politica delle risorse: salta il caricamento di risorse esterne copre
WhitelistedResources,IExternalResourceHandlere la gestione degli script in dettaglio - Verifica cosa tocca la rete: accesso alla rete e privacy dei dati
- Segui la guida passo passo: converti upload non attendibili in modo sicuro – caso d’uso
- Esplora il campione funzionante: secure-untrusted-document-upload-conversion-dotnet su GitHub