💡 Exemple complet fonctionnel disponible sur GitHub : secure-untrusted-document-upload-conversion-dotnet
Le défi de la comptabilité fournisseurs : pourquoi la conversion des téléchargements de fournisseurs échoue à grande échelle
Votre serveur convertit la facture ; le HTML du fournisseur décide ce qu’il lit ensuite. La conversion sécurisée des téléchargements de fournisseurs avec GroupDocs.Conversion pour .NET transforme un fichier téléchargé en PDF sans laisser les références du fichier choisir ce que votre serveur récupère ou lit ensuite.
Un portail de facturation fournisseur permet à tout fournisseur approuvé de télécharger une facture – généralement en HTML ou en PDF, parfois avec un dessin SVG joint pour un poste d’infrastructure ou de construction – et le système de comptabilité fournisseurs le convertit en PDF pour l’archivage et le routage d’approbation. Le fournisseur a écrit ce HTML, pas votre équipe, et il peut référencer tout ce qu’une page web peut référencer : une feuille de style, un script, une image hébergée sur le CDN du fournisseur, ou – si le compte du fournisseur a été compromis – une adresse qui n’était jamais censée être accessible depuis votre réseau.
Le volume des fournisseurs ne cesse de croître. Lorsqu’il passe de quelques fournisseurs à des centaines, le dossier de téléchargements qui ne contenait auparavant les fichiers d’une seule société contient maintenant ceux de tout le monde – et une référence d’image relative dans la facture d’un fournisseur peut se résoudre à un fichier appartenant à un autre fournisseur juste à côté.
Ce dont une équipe de comptabilité fournisseurs a réellement besoin n’est pas une règle de pare-feu réseau, mais une étape de conversion qui traite chaque référence à l’intérieur d’un téléchargement comme non fiable par défaut, laisse passer délibérément un actif examiné comme le logo d’un fournisseur, et échoue bruyamment – et non silencieusement – lorsqu’une entrée de liste blanche est mal configurée.
Vérification de la réalité : une balise
<img>pointant vers
http://169.254.169.254/latest/meta-data/iam/security-credentials/demande au serveur de conversion d’appeler le service de métadonnées du cloud – une requête que le téléchargeur ne pourrait jamais faire depuis l’extérieur. Il s’agit d’une falsification de requête côté serveur, et un simple téléchargement HTML suffit.
Pourquoi les correctifs génériques ne comblent pas cette lacune
Les équipes de comptabilité fournisseurs se tournent généralement vers l’une de ces solutions avant d’adopter une bibliothèque de conversion avec sa propre politique de ressources :
- Blocage de la sortie réseau sur l’hôte de conversion : empêche une récupération distante, mais ne fait rien contre un fichier du même dossier qu’une référence relative peut résoudre – exactement ce qui se produit lorsqu’un téléchargement est converti directement depuis son chemin enregistré.
- Suppression des balises avant la conversion : fragile face aux nouveaux types de références (
<link>, SVG<image>, CSS@import) et doit être ré‑auditée chaque fois que le format du téléchargement change. - Faire confiance au scanner de téléchargement du portail fournisseur : recherche les signatures de logiciels malveillants, pas une URL pointant vers votre propre infrastructure.
GroupDocs.Conversion comble cette lacune au moment où cela compte le plus : au moment où le document est chargé pour la conversion, avant que toute sortie ne soit produite.
La solution : GroupDocs.Conversion dans un flux de travail de facturation fournisseur
GroupDocs.Conversion pour .NET 26.10 refuse les ressources externes par défaut via SkipExternalResources, vous permet de nommer exactement les emplacements que vous faites confiance via WhitelistedResources, et vous offre un rappel par ressource via IExternalResourceHandler qui peut confirmer, remplacer ou fournir les octets d’une ressource directement – ainsi un logo de fournisseur examiné peut toujours apparaître dans le PDF de sortie sans qu’aucune requête réseau ne soit jamais effectuée.
Pour suivre l’implémentation ci‑dessous, vous aurez besoin de :
- .NET 8.0 ou ultérieur
- GroupDocs.Conversion pour .NET (obtenez un essai gratuit)
- Un exemple de téléchargement HTML ou SVG que vous ne contrôlez pas
dotnet add package GroupDocs.Conversion --version 26.10.0
Implémentation de l’étape de conversion des téléchargements fournisseurs, pas à pas
L’exemple ci‑dessous correspond à un scénario réel de portail fournisseur : conversion d’une facture téléchargée (invoice-upload.html) qui référence un logo, une adresse interne, un fichier local et un fichier adjacent.
La plupart des extraits ci‑dessous utilisent un objet ResourceAudit – un petit IExternalResourceHandler qui enregistre chaque décision de chargement et peut fournir les octets d’un actif fiable. Son code complet se trouve dans le fichier Program.cs du dépôt d’exemple.
Étape 1 - Charger et convertir depuis le chemin enregistré du téléchargement
Voici comment un portail pourrait convertir un téléchargement immédiatement après l’avoir enregistré dans un dossier partagé – et l’étape où un fichier frère peut s’infiltrer.
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;
Charger directement depuis uploadPath place tout le dossier de la facture dans le périmètre, pas seulement le fichier unique qu’il contient. Le périmètre, pas la confiance, détermine ce qui se charge. Dans cet exécution, chaque référence distante et chaque référence file:/// dans la facture sont bloquées, mais other-customer-signature.svg – un autre fichier enregistré dans le même dossier – se charge, car SkipExternalResources n’exclut que les références situées en dehors de ce dossier.
Étape 2 - Configurer pour les exigences des téléchargements fournisseurs
Pour les téléchargements fournisseurs, supprimez complètement le dossier de base en chargeant depuis un flux au lieu d’un chemin :
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;
Pourquoi ce paramètre est important pour les portails fournisseurs :
- Entrée en flux : un document converti depuis un flux n’a aucun dossier, donc une référence relative à l’intérieur ne peut pas se résoudre à un fichier d’un autre fournisseur.
ExternalResourceHandler: s’exécute toujours pour chaque ressource, vous permettant de garder une trace exacte de ce que chaque téléchargement fournisseur a demandé.
Étape 3 - Exécuter et fournir un actif examiné
Le logo d’un fournisseur est une référence que vous pouvez réellement vouloir conserver – fourni à partir d’une copie que vous contrôlez, et non récupéré depuis l’URL du fournisseur :
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;
Le gestionnaire de ResourceAudit vérifie l’URL demandée par rapport à un dictionnaire d’actifs fiables ; lorsqu’elle correspond, il définit ExternalResourceLoadingArgs.Data sur les octets locaux et Skipped sur false, de sorte que le logo apparaît dans le PDF de sortie tandis que les cinq autres références de la facture restent bloquées.
Étape 4 - Rejeter tôt une entrée de liste blanche mal configurée
Une entrée de liste blanche qui n’est qu’un nom d’hôte, et non un préfixe d’URI absolu, fait échouer la conversion au lieu de correspondre silencieusement à trop de choses :
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;
}
Passer cdn.example.com au lieu de https://cdn.example.com/brand/ lève une InvalidLoadOptionsException avec le message : 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/'. Capturer cela au moment de la conversion, lors d’une révision de configuration ou d’un contrôle au démarrage, est bien moins coûteux que de le découvrir à partir d’une ressource mal correspondante en production. Attrapez‑le avant qu’il ne soit déployé.
Pourquoi une entrée de liste blanche d’URL serait‑elle jamais rejetée ?
WhitelistedResources n’accepte que des préfixes d’URI absolus, tels que https://cdn.example.com/brand/ ou file:///C:/assets/. Les versions antérieures correspondaient à une entrée partout où elle apparaissait dans l’URL, de sorte que cdn.example.com correspondait également à l’adresse d’un attaquant contenant simplement ces mots. Depuis la version 26.10, cette entrée échoue le chargement avec InvalidLoadOptionsException, et la dernière méthode de l’exemple affiche le message exact.
Les pièces jointes SVG des fournisseurs comportent le même risque
Un dessin d’infrastructure joint à une facture de construction n’est toujours qu’un fichier SVG, et il passe par SvgLoadOptions au lieu de WebLoadOptions. Même contrat, élément différent : le ExternalResourceHandler s’applique à ses références <image> de la même façon qu’il s’appliquait aux balises <img> de la facture, et tout <script> en ligne que le dessin porte ne s’exécute pas :
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;
C’est exactement le scénario de facture de construction présenté en introduction : un dessin qui ressemble à un simple plan d’étage peut tout de même contenir une référence à votre point de terminaison de métadonnées cloud, à un fichier local ou au serveur d’un attaquant. Dans l’exemple fonctionnel, les trois sont bloqués, et la légende s’affiche exactement comme dessinée, car le script qui y était attaché ne s’exécute jamais.
Comportement avant et après
| Vérification | Conversion directe depuis le chemin enregistré | Cette approche |
|---|---|---|
| Fichier frère du même dossier | Chargé automatiquement | Bloqué – l’entrée en flux supprime le dossier de base |
| Logo du fournisseur | Bloqué ; le PDF n’affiche que son texte alternatif | Fourni à partir d’un fichier local examiné |
| Métadonnées cloud / adresse interne | Bloqué par défaut | Bloqué par défaut |
| Entrée de liste blanche uniquement nom d’hôte | Rejetée avec InvalidLoadOptionsException |
Rejetée de la même façon, capturée lors d’un contrôle de démarrage |
| Script en ligne dans le téléchargement | Ne s’exécute pas | Ne s’exécute pas |
Deux lignes changent : le logo et le fichier frère. Le fichier frère est celui qu’une revue au niveau réseau ne détecterait jamais, car aucune requête réseau n’est impliquée.
Autres scénarios de documents fournisseurs où cela s’applique
La même propriété ExternalResourceHandler existe sur les options de chargement pour plusieurs autres formats que les portails fournisseurs acceptent couramment, de sorte que le modèle ci‑dessus n’est pas limité à HTML et SVG :
- Documents Word ou Excel soumis par le fournisseur :
WordProcessingLoadOptionsetSpreadsheetLoadOptionsexposent le même contrat de gestionnaire. - Factures envoyées par e‑mail :
EmailLoadOptionsexpose le même gestionnaire pour les images distantes référencées dans le corps d’un e‑mail. - Déclarations financières XBRL :
FinanceLoadOptionscouvre les références de taxonomie dans les documents XBRL soumis par le fournisseur.
Démarrer avec votre pipeline de téléchargement fournisseur
Vous avez vu comment GroupDocs.Conversion gère en toute sécurité les téléchargements fournisseurs non fiables. Voici les prochaines étapes :
- Commencer gratuitement : obtenez une licence temporaire pour supprimer les limites d’évaluation
- Lire la politique complète des ressources : ignorer le chargement des ressources externes couvre
WhitelistedResources,IExternalResourceHandleret la gestion des scripts en détail - Vérifier ce qui touche le réseau : accès réseau et confidentialité des données
- Suivre le guide pas à pas : convertir les téléchargements non fiables en toute sécurité – cas d’utilisation
- Explorer l’exemple fonctionnel : secure-untrusted-document-upload-conversion-dotnet sur GitHub