💡 Tam çalışan örnek GitHub’da mevcuttur: secure-untrusted-document-upload-conversion-dotnet
Hesap Ödemeleri Zorluğu: Neden Tedarikçi Yükleme Dönüştürmesi Ölçeklendikçe Bozulur
Sunucunuz faturayı dönüştürür; tedarikçinin HTML’i ne okunacağını belirler. GroupDocs.Conversion for .NET ile güvenli tedarikçi‑yükleme dönüşümü, bir yüklenen dosyayı PDF’ye çevirirken dosyanın kendi referanslarının sunucunuzun bir sonraki neyi alıp okuyacağını seçmesine izin vermez.
Bir tedarikçi fatura portalı, onaylı herhangi bir tedarikçinin fatura yüklemesine izin verir – genellikle HTML ya da PDF olarak, bazen bir tesis ya da inşaat kalemi için eklenmiş bir SVG çizimiyle – ve hesap‑ödemeleri sistemi bunu arşiv ve onay yönlendirmesi için PDF’ye dönüştürür. HTML’i tedarikçi yazar, sizin ekibiniz değil ve bir web sayfasının referans gösterebileceği her şeyi referans gösterebilir: bir stil sayfası, bir betik, tedarikçinin kendi CDN’sinde barındırılan bir resim ya da – tedarikçi hesabı ele geçirilmişse – ağınızdan hiç ulaşılması amaçlanmamış bir adres.
Tedarikçi hacmi sadece artar. Birkaç tedarikçiden yüzlerceye çıktığında, bir zamanlar bir şirketin dosyalarını tutan yükleme klasörü artık herkesin dosyalarını tutar – ve bir tedarikçinin faturasındaki göreli resim referansı, yanındaki farklı bir tedarikçiye ait bir dosyaya çözülebilir.
Bir hesap‑ödemeleri ekibinin gerçekten ihtiyacı olan şey bir ağ güvenlik duvarı kuralı değil, her yüklemedeki referansı varsayılan olarak güvensiz kabul eden, tedarikçi logosu gibi incelenmiş bir varlığı kasıtlı olarak geçiren ve bir beyaz liste girdisi yanlış yazıldığında sessizce değil yüksek sesle başarısız olan bir dönüştürme adımıdır.
Gerçek kontrol:
<img>etiketiyle işaretlenmiş
http://169.254.169.254/latest/meta-data/iam/security-credentials/adresi, dönüştüren sunucunun bulut meta‑veri hizmetini çağırmasını ister – dışarıdan asla yapılamayacak bir istek. Bu, sunucu‑tarafı istek sahteciliğidir ve bir HTML yüklemesi bunun için yeterlidir.
Neden Genel Çözümler Bu Açığı Kapatmaz
Hesap‑ödemeleri ekipleri, kendi kaynak politikası olan bir dönüştürme kütüphanesini benimsemeden önce genellikle şunlara yönelir:
- Dönüştürme sunucusunda ağ çıkışı engelleme: uzaktan bir çekmeyi durdurur, ancak göreli bir referansın çözebileceği aynı klasör dosyasıyla ilgili hiçbir şey yapmaz – tam da bir yükleme kaydedilen yolundan doğrudan dönüştürüldüğünde olan şey.
- Dönüştürmeden önce etiketleri temizleme: yeni referans türlerine (
<link>, SVG<image>, CSS@import) karşı kırılgandır ve yükleme formatı değiştiğinde yeniden denetlenmesi gerekir. - Tedarikçi portalının kendi yükleme tarayıcısına güvenme: kötü amaçlı yazılım imzalarını tarar, kendi altyapınıza işaret eden bir URL’yi taramaz.
GroupDocs.Conversion bu boşluğu, en kritik noktada kapatır: belge dönüştürme için yüklendiği anda, herhangi bir çıktı üretilmeden önce.
Çözüm: Tedarikçi Fatura İş Akışında GroupDocs.Conversion
GroupDocs.Conversion for .NET 26.10, SkipExternalResources ile dış kaynakları varsayılan olarak reddeder, WhitelistedResources ile tam olarak güvendiğiniz konumları adlandırmanıza izin verir ve IExternalResourceHandler aracılığıyla her kaynak için bir geri çağırma sunar; bu geri çağırma, bir kaynağın baytlarını doğrudan onaylayabilir, geçersiz kılabilir veya sağlayabilir – böylece incelenmiş bir tedarikçi logosu, ağ isteği yapılmadan çıktı PDF’sinde görünebilir.
Aşağıdaki uygulamayı izlemek için şunlara ihtiyacınız olacak:
- .NET 8.0 veya üzeri
- GroupDocs.Conversion for .NET (ücretsiz deneme alın)
- Kontrolünüz dışındaki bir örnek HTML veya SVG yüklemesi
dotnet add package GroupDocs.Conversion --version 26.10.0
Tedarikçi Yükleme Dönüştürme Adımını Adım Adım Uygulama
Aşağıdaki örnek, gerçek bir tedarikçi‑portal senaryosuna karşılık gelir: bir logo, bir iç adres, yerel bir dosya ve yanındaki bir dosyaya referans veren bir yüklenmiş fatura (invoice-upload.html) dönüştürülür.
Aşağıdaki çoğu snippet, her yükleme kararını kaydeden ve güvenilir bir varlığın baytlarını sağlayabilen küçük bir IExternalResourceHandler olan ResourceAudit nesnesi geçirir. Tam kodu
Program.cs örnek deposunda bulabilirsiniz.
Adım 1 - Yüklemenin Kaydedilen Yolundan Yükle ve Dönüştür
Bu, bir portalın yüklemeyi kaydettikten hemen sonra bir ortak klasöre dönüştürmesinin yoludur – ve kardeş dosyanın sızabileceği adımdır.
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;
uploadPath üzerinden doğrudan yükleme, faturanın tüm klasörünü kapsam içine alır, sadece içindeki tek dosyayı değil. Kapsam, güven yerine, neyin yükleneceğini belirler. Bu çalışmada, faturadaki her uzak ve file:/// referansı engellenir, ancak aynı klasörde kaydedilmiş other-customer-signature.svg dosyası yüklenir; çünkü SkipExternalResources yalnızca o klasör dışındaki referansları dışlar.
Adım 2 - Tedarikçi‑Yükleme Gereksinimlerine Göre Yapılandır
Tedarikçi yüklemeleri için temel klasörü tamamen kaldırın; yolu değil bir akışı (stream) kullanarak yükleyin:
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;
Bu ayarın tedarikçi portalları için neden önemli olduğu:
- Akış girişi: akıştan dönüştürülen bir belge klasöre sahip değildir, bu yüzden içindeki göreli referans başka bir tedarikçinin dosyasına çözülemez.
ExternalResourceHandler: hâlâ her kaynak için çalışır, böylece her tedarikçi yüklemesinin tam olarak ne istediğini kaydedersiniz.
Adım 3 - İncelenmiş Bir Varlığı Yürüt ve Yakala
Bir tedarikçi logosu, tutmak isteyebileceğiniz bir referanstır – tedarikçinin kendi URL’sinden çekilmek yerine kontrol ettiğiniz bir kopyadan sağlanır:
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;
ResourceAudit‘in işleyicisi, istenen URL’yi güvenilir varlık sözlüğüyle karşılaştırır; eşleştiğinde ExternalResourceLoadingArgs.Data yerel baytlara, Skipped ise false olarak ayarlanır, böylece logo çıktı PDF’sinde görünürken faturadaki diğer beş referans engellenir.
Adım 4 - Yanlış Yapılandırılmış Bir Beyaz Liste Girdisini Erken Reddet
Sadece bir ana bilgisayar adı olan, mutlak bir URI öneki olmayan bir beyaz liste girdisi, çok fazla eşleşme yapmadan dönüşümü başarısız kılar:
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;
}
cdn.example.com yerine https://cdn.example.com/brand/ vermek, InvalidLoadOptionsException ile şu mesajı fırlatır: 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/'. Bu hatayı bir yapılandırma incelemesi ya da başlangıç kontrolü sırasında yakalamak, üretimde hatalı eşleşen bir kaynağı keşfetmekten çok daha ucuzdur. Gönderilmeden önce yakalayın.
Bir URL beyaz liste girdisinin neden reddedilebileceği
WhitelistedResources yalnızca mutlak URI öneklerini kabul eder; örneğin https://cdn.example.com/brand/ ya da file:///C:/assets/. Önceki sürümler, bir girdiyi URL içinde nerede görünürse görünsün eşleştiriyordu, bu yüzden cdn.example.com saldırganın sadece bu kelimeleri içeren adresine de eşleşiyordu. 26.10’dan itibaren bu giriş, InvalidLoadOptionsException ile yüklemeyi reddeder ve örnek kodun son yöntemi tam mesajı yazdırır.
Tedarikçi SVG Ekleri Aynı Riski Taşıyor
Bir tesis çizimi, inşaat faturasıyla eklenmiş olsa da hâlâ bir SVG dosyasıdır ve WebLoadOptions yerine SvgLoadOptions üzerinden geçer. Aynı sözleşme, farklı öğe: ExternalResourceHandler onun <image> referanslarına, faturadaki <img> etiketlerine uygulandığı gibi uygulanır ve çizimin taşıdığı herhangi bir satır içi <script> çalışmaz:
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;
Bu, açılıştaki inşaat‑fatura senaryosunun tam aynısıdır: sadece bir kat planı gibi görünen bir çizim, yine de bulut meta‑veri uç noktanıza, yerel bir dosyaya ya da saldırganın sunucusuna referans taşıyabilir. Çalışan örnek tüm üçünü engeller ve başlık tam olarak çizildiği gibi render edilir, çünkü ona eklenen betik hiç çalışmaz.
Önce ve Sonra Davranışı
| Kontrol | Kaydedilen yoldan doğrudan dönüştürme | Bu yaklaşım |
|---|---|---|
| Aynı klasördeki kardeş dosya | Otomatik olarak yüklenir | Engellendi – akış girişi temel klasörü kaldırır |
| Tedarikçi logosu | Engellendi; PDF sadece alt metnini gösterir | İncelenmiş yerel dosyadan sağlanır |
| Bulut meta‑verisi / iç adres | Varsayılan olarak engellendi | Varsayılan olarak engellendi |
| Sadece ana bilgisayar adı beyaz liste girdisi | InvalidLoadOptionsException ile reddedilir |
Aynı şekilde reddedilir, başlangıç kontrolüyle yakalanır |
| Yüklemedeki satır içi betik | Çalışmaz | Çalışmaz |
İki satır değişir: logo ve kardeş dosya. Kardeş dosya, ağ düzeyinde bir incelemenin asla yakalayamayacağı bir durumdur, çünkü ağ isteği gerçekleşmez.
Bu Duruma Uygun Diğer Tedarikçi‑Belge Senaryoları
ExternalResourceHandler özelliği, tedarikçi portallarının yaygın olarak kabul ettiği birkaç başka formatın yükleme seçeneklerinde de bulunur; bu yüzden yukarıdaki desen yalnızca HTML ve SVG ile sınırlı değildir:
- Tedarikçi‑gönderimli Word veya Excel ekleri:
WordProcessingLoadOptionsveSpreadsheetLoadOptionsaynı işleyici sözleşmesini sunar. - E‑posta ile gönderilen faturalar:
EmailLoadOptionse‑posta gövdesinin uzaktan referans verdiği resimler için aynı işleyiciyi sunar. - XBRL finansal beyanları:
FinanceLoadOptionstedarikçi‑gönderimli XBRL belgelerindeki taksonomi referanslarını kapsar.
Tedarikçi Yükleme Boru Hattınıza Başlangıç
GroupDocs.Conversion’ın güvensiz tedarikçi yüklemelerini nasıl güvenli bir şekilde ele aldığını gördünüz. Şimdi yapmanız gerekenler:
- Ücretsiz başlayın: geçici bir lisans alın ve değerlendirme sınırlamalarını kaldırın
- Tam kaynak politikasını okuyun: dış kaynakların yüklenmesini atlama
WhitelistedResources,IExternalResourceHandlerve betik işleme konularını ayrıntılı olarak kapsar - Ağda neyin dokunduğunu kontrol edin: ağ erişimi ve veri gizliliği
- Adım adım kılavuzu izleyin: güvensiz yüklemeleri güvenli bir şekilde dönüştür – kullanım durumu
- Çalışan örneği inceleyin: secure-untrusted-document-upload-conversion-dotnet GitHub’da