💡 Exemplo completo funcionando disponível no GitHub:
secure-untrusted-document-upload-conversion-dotnet
O Desafio de Contas a Pagar: Por que a Conversão de Upload de Fornecedor Falha em Escala
Seu servidor converte a fatura; o HTML do fornecedor decide o que mais ele lê. A conversão segura de upload de fornecedor com GroupDocs.Conversion for .NET transforma um arquivo enviado em PDF sem permitir que as próprias referências do arquivo escolham o que seu servidor busca ou lê a seguir.
Um portal de faturas de fornecedor permite que qualquer fornecedor aprovado envie uma fatura – geralmente como HTML ou PDF, às vezes com um desenho SVG anexado para um item de instalações ou construção – e o sistema de contas a pagar a converte em PDF para arquivamento e roteamento de aprovação. O fornecedor escreveu esse HTML, não sua equipe, e ele pode referenciar qualquer coisa que uma página da web pode referenciar: uma folha de estilo, um script, uma imagem hospedada no próprio CDN do fornecedor ou – se a conta do fornecedor foi comprometida – um endereço que nunca deveria ser acessível a partir da sua rede.
O volume de fornecedores só aumenta. Quando passa de alguns poucos fornecedores para centenas, a pasta de uploads que antes continha os arquivos de uma empresa agora contém os de todos – e uma referência de imagem relativa dentro da fatura de um fornecedor pode resolver para um arquivo que pertence a outro fornecedor que está ao lado.
O que uma equipe de contas a pagar realmente precisa não é uma regra de firewall de rede, mas uma etapa de conversão que trate cada referência dentro de um upload como não confiável por padrão, permita que um ativo revisado, como o logotipo de um fornecedor, passe deliberadamente, e falhe de forma evidente – não silenciosa – quando uma entrada da lista branca está escrita incorretamente.
Verificação da realidade: uma única tag
<img>apontando parahttp://169.254.169.254/latest/meta-data/iam/security-credentials/solicita ao servidor de conversão que chame o serviço de metadados da nuvem – uma solicitação que o remetente nunca poderia fazer de fora. Isso é falsificação de solicitação do lado do servidor, e um upload de HTML é tudo o que é necessário.
Por que Correções Genéricas Não Fecham Essa Lacuna
Equipes de contas a pagar normalmente recorrem a uma destas antes de adotar uma biblioteca de conversão com sua própria política de recursos:
- Bloqueio de saída de rede no host de conversão: impede uma busca remota, mas não faz nada em relação a um arquivo na mesma pasta que uma referência relativa pode resolver – exatamente o que acontece quando um upload é convertido diretamente do seu caminho salvo.
- Remoção de tags antes da conversão: frágil contra novos tipos de referência (
<link>, SVG<image>, CSS@import) e precisa ser reavaliado toda vez que o formato do upload mudar. - Confiar no scanner de upload próprio do portal do fornecedor: verifica assinaturas de malware, não uma URL que aponta para sua própria infraestrutura.
O GroupDocs.Conversion fecha essa lacuna no ponto que mais importa: o momento em que o documento é carregado para conversão, antes que qualquer saída seja produzida.
A Solução: GroupDocs.Conversion em um Fluxo de Trabalho de Fatura de Fornecedor
O GroupDocs.Conversion for .NET 26.10 nega recursos externos por padrão através de SkipExternalResources, permite que você nomeie exatamente as localidades que confia através de WhitelistedResources, e fornece um callback por recurso através de IExternalResourceHandler que pode confirmar, sobrescrever ou fornecer os bytes do recurso diretamente – assim, um logotipo de fornecedor revisado ainda pode aparecer no PDF de saída sem que nenhuma solicitação de rede seja feita para ele.
Para seguir a implementação abaixo, você precisará:
- .NET 8.0 ou posterior
- GroupDocs.Conversion for .NET (obtenha um teste gratuito)
- Um upload de exemplo HTML ou SVG que você não controla
dotnet add package GroupDocs.Conversion --version 26.10.0
Implementando a Etapa de Conversão de Upload de Fornecedor Passo a Passo
O exemplo abaixo corresponde a um cenário real de portal de fornecedor: converter uma fatura enviada (invoice-upload.html) que referencia um logotipo, um endereço interno, um arquivo local e um arquivo ao lado dele.
A maioria dos trechos abaixo passa um objeto ResourceAudit – um pequeno IExternalResourceHandler que registra cada decisão de carregamento e pode fornecer os bytes de um ativo confiável. Seu código completo está em Program.cs do repositório de exemplo.
Etapa 1 - Carregar e Converter a Partir do Caminho Salvo do Upload
É assim que um portal pode converter um upload imediatamente após salvá-lo em uma pasta compartilhada – e a etapa onde um arquivo irmão pode vazar.
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;
Carregar diretamente de uploadPath coloca toda a pasta da fatura em escopo, não apenas o único arquivo dentro dela. O escopo, não a confiança, decide o que é carregado. Nesta execução, toda referência remota e file:/// na fatura é bloqueada, mas other-customer-signature.svg – um arquivo diferente salvo na mesma pasta – é carregado, porque SkipExternalResources exclui apenas referências fora dessa pasta.
Etapa 2 - Configurar para Requisitos de Upload de Fornecedor
Para uploads de fornecedor, remova completamente a pasta base carregando a partir de um stream em vez de um caminho:
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;
Por que essa configuração importa para portais de fornecedor:
- Entrada de stream: um documento convertido a partir de um stream não tem pasta, portanto uma referência relativa dentro dele não pode resolver para o arquivo de outro fornecedor.
ExternalResourceHandler: ainda é executado para cada recurso, assim você mantém um registro exatamente do que cada upload de fornecedor solicitou.
Etapa 3 - Executar e Capturar um Ativo Revisado
O logotipo de um fornecedor é uma referência que você pode realmente querer manter – fornecida a partir de uma cópia que você controla, não buscada a partir da URL do próprio fornecedor:
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;
O manipulador de ResourceAudit verifica a URL solicitada contra um dicionário de ativos confiáveis; quando corresponde, define ExternalResourceLoadingArgs.Data para os bytes locais e Skipped para false, de modo que o logotipo aparece no PDF de saída enquanto as outras cinco referências da fatura permanecem bloqueadas.
Etapa 4 - Rejeitar uma Entrada de Lista Branca Mal Configurada Cedo
Uma entrada de lista branca que é apenas um nome de host, não um prefixo de URI absoluto, falha a conversão em vez de combinar silenciosamente em excesso:
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;
}
Passar cdn.example.com em vez de https://cdn.example.com/brand/ lança InvalidLoadOptionsException com a mensagem: 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/'. Capturar isso no momento da conversão, em uma revisão de configuração ou verificação de inicialização, é muito mais barato do que descobri-lo a partir de um recurso correspondido incorretamente em produção. Capture antes de ser enviado.
Por que uma entrada de lista branca de URL poderia ser rejeitada?
WhitelistedResources aceita apenas prefixos de URI absolutos, como https://cdn.example.com/brand/ ou file:///C:/assets/. Versões anteriores combinavam uma entrada onde quer que aparecesse na URL, então cdn.example.com também correspondia a um endereço de atacante que apenas continha essas palavras. Desde a 26.10 essa entrada falha o carregamento com InvalidLoadOptionsException, e o último método do exemplo imprime a mensagem exata.
Anexos SVG de Fornecedor Têm o Mesmo Risco
Um desenho de instalações anexado a uma fatura de construção ainda é apenas um arquivo SVG, e ele passa por SvgLoadOptions em vez de WebLoadOptions. Mesmo contrato, elemento diferente: o ExternalResourceHandler se aplica às suas referências <image> da mesma forma que se aplicava às tags <img> da fatura, e qualquer <script> embutido que o desenho contenha não é executado:
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;
Este é exatamente o cenário de fatura de construção da introdução: um desenho que parece nada mais que um plano de piso ainda pode conter uma referência ao seu endpoint de metadados da nuvem, a um arquivo local ou ao servidor de um atacante. No exemplo funcional, todos os três são bloqueados, e a legenda é renderizada exatamente como desenhada, porque o script anexado a ela nunca é executado.
Comportamento Antes e Depois
| Verificação | Convertendo diretamente do caminho salvo | Esta abordagem |
|---|---|---|
| Arquivo irmão na mesma pasta | Carrega automaticamente | Bloqueado – entrada de stream remove a pasta base |
| Logotipo do fornecedor | Bloqueado; o PDF mostra apenas seu texto alt | Fornecido a partir de um arquivo local revisado |
| Metadados da nuvem / endereço interno | Bloqueado por padrão | Bloqueado por padrão |
| Entrada de lista branca apenas com nome de host | Rejeitado com InvalidLoadOptionsException |
Rejeitado da mesma forma, capturado por uma verificação de inicialização |
| Script embutido no upload | Não executa | Não executa |
Duas linhas mudam: o logotipo e o arquivo irmão. O arquivo irmão é o que uma revisão em nível de rede nunca capturaria, porque nenhuma solicitação de rede está envolvida.
Outros Cenários de Documentos de Fornecedor Onde Isso se Aplica
A mesma propriedade ExternalResourceHandler existe nas opções de carregamento para vários outros formatos que os portais de fornecedor costumam aceitar, portanto o padrão acima não se limita a HTML e SVG:
- Anexos Word ou Excel enviados pelo fornecedor:
WordProcessingLoadOptionseSpreadsheetLoadOptionsexpõem o mesmo contrato de manipulador. - Faturas enviadas por e‑mail:
EmailLoadOptionsexpõe o mesmo manipulador para as imagens remotas que o corpo do e‑mail referencia. - Arquivos financeiros XBRL:
FinanceLoadOptionscobre referências de taxonomia em documentos XBRL enviados pelo fornecedor.
Começando com Seu Pipeline de Upload de Fornecedor
Você viu como o GroupDocs.Conversion lida com uploads de fornecedor não confiáveis de forma segura. Aqui está o que fazer a seguir:
- Comece grátis: obtenha uma licença temporária para remover os limites de avaliação
- Leia a política completa de recursos: pular o carregamento de recursos externos cobre
WhitelistedResources,IExternalResourceHandlere o tratamento de scripts em detalhes - Verifique o que toca a rede: acesso à rede e privacidade de dados
- Siga o guia passo a passo: converter uploads não confiáveis com segurança – caso de uso
- Explore o exemplo funcional: secure-untrusted-document-upload-conversion-dotnet no GitHub