💡 مثال كامل يعمل متاح على GitHub:
secure-untrusted-document-upload-conversion-dotnet

تحدي الحسابات المستحقة: لماذا فشل تحويل تحميل المورد عند النطاق الواسع

يقوم خادمك بتحويل الفاتورة؛ HTML الخاص بالمورد يحدد ما يقرأه بعد ذلك. تحويل تحميل المورد بأمان باستخدام GroupDocs.Conversion لـ .NET يحول الملف المرفوع إلى PDF دون السماح لمراجع الملف الخاصة باختيار ما سيجلبه خادمك أو يقرأه لاحقًا.

بوابة فواتير المورد تسمح لأي مورد معتمد بتحميل فاتورة – عادةً كـ HTML أو PDF، أحيانًا مع رسم SVG مرفق لبند مرافق أو بناء – ويقوم نظام الحسابات المستحقة بتحويلها إلى PDF للأرشفة وتوجيه الموافقة. كتب المورد هذا الـ HTML، ليس فريقك، ويمكنه الإشارة إلى أي شيء يمكن لصفحة ويب الإشارة إليه: ورقة أنماط، سكريبت، صورة مستضافة على CDN الخاص بالمورد، أو - إذا تم اختراق حساب المورد - عنوان لم يكن من المفترض أن يكون قابلًا للوصول من شبكتك مطلقًا.

حجم الموردين يزداد فقط. عندما ينتقل من عدد قليل من الموردين إلى مئات، يصبح مجلد التحميلات الذي كان يحتوي على ملفات شركة واحدة الآن يحتوي على ملفات الجميع – ويمكن لإشارة صورة نسبية داخل فاتورة أحد الموردين أن تُحل إلى ملف يخص موردًا آخر يجلس بجوارها.

ما يحتاجه فريق الحسابات المستحقة فعليًا ليس قاعدة جدار ناري شبكي، بل خطوة تحويل تُعامل كل إشارة داخل التحميل على أنها غير موثوقة بشكل افتراضي، وتسمح بمرور أصل مُراجَع مثل شعار المورد عن قصد، وتفشل بصوت عالٍ – لا بصمت – عندما تُكتب إدخال القائمة البيضاء بشكل خاطئ.

فحص الواقع: علامة <img> واحدة تشير إلى
http://169.254.169.254/latest/meta-data/iam/security-credentials/ تطلب من الخادم المحول استدعاء خدمة بيانات التعريف السحابية – طلب لا يمكن للرافع أن ينفذه من الخارج. هذا هو تزوير طلب من جانب الخادم، وتحميل HTML هو كل ما يلزم.

لماذا لا تُغلق الإصلاحات العامة هذه الفجوة

عادةً ما تلجأ فرق الحسابات المستحقة إلى أحد هذه الخيارات قبل اعتماد مكتبة تحويل ذات سياسة موارد خاصة:

  • حجب الخروج الشبكي على مضيف التحويل: يوقف جلبًا بعيدًا، لكنه لا يفعل شيئًا بخصوص ملف في نفس المجلد يمكن لإشارة نسبية أن تُحل إليه – وهو بالضبط ما يحدث عندما يتم تحويل تحميل مباشرةً من مساره المحفوظ.
  • إزالة العلامات قبل التحويل: هشّ ضد أنواع الإشارات الجديدة (<link>، SVG <image>، CSS @import) ويجب مراجعته مرة أخرى كلما تغير تنسيق التحميل.
  • الثقة بمسح التحميل الخاص ببوابة المورد: يفحص توقيعات البرمجيات الخبيثة، وليس عنوان URL الذي يشير إلى بنيتك التحتية الخاصة.

GroupDocs.Conversion يغلق هذه الفجوة في النقطة التي تهم أكثر: لحظة تحميل المستند للتحويل، قبل إنتاج أي مخرجات.

الحل: GroupDocs.Conversion في سير عمل فاتورة المورد

GroupDocs.Conversion لـ .NET الإصدار 26.10 يرفض الموارد الخارجية بشكل افتراضي عبر SkipExternalResources، ويسمح لك بتحديد المواقع التي تثق بها بدقة عبر WhitelistedResources، ويعطيك رد نداء لكل مورد عبر IExternalResourceHandler يمكنه تأكيد أو تجاوز أو توفير بايتات المورد مباشرةً – بحيث يمكن لشعار مورد مُراجَع أن يظل يظهر في PDF الناتج دون أي طلب شبكة يُجرى من أجله.

للتبع التنفيذ أدناه، ستحتاج إلى:

dotnet add package GroupDocs.Conversion --version 26.10.0

تنفيذ خطوة تحويل تحميل المورد خطوة بخطوة

المثال أدناه يتطابق مع سيناريو بوابة مورد حقيقي: تحويل فاتورة مرفوعة (invoice-upload.html) تشير إلى شعار، عنوان داخلي، ملف محلي، وملف يجلس بجواره.

معظم المقاطع البرمجية أدناه تمرّ كائن ResourceAudit – وهو IExternalResourceHandler صغير يسجل كل قرار تحميل ويمكنه توفير بايتات أصل موثوق. الكود الكامل موجود في
Program.cs من المستودع العيني.

الخطوة 1 - التحميل والتحويل من مسار التحميل المحفوظ

هذا هو ما قد تفعله بوابة لتحويل تحميل فور حفظه في مجلد مشترك – والخطوة التي يمكن فيها لملف شقيق أن يتسرب.

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 يضع مجلد الفاتورة بأكمله في النطاق، وليس الملف الواحد داخل المجلد فقط. النطاق، لا الثقة، يحدد ما يُحمَّل. في هذا التشغيل، كل إشارة عن بُعد وإشارة file:/// في الفاتورة تُحَجَب، لكن other-customer-signature.svg – ملف مختلف محفوظ في نفس المجلد – يُحمَّل، لأن SkipExternalResources يستثني فقط الإشارات خارج ذلك المجلد.

الخطوة 2 - التكوين لمتطلبات تحميل المورد

لتحميلات المورد، أزل مجلد القاعدة تمامًا بتحميل من تدفق بدلاً من مسار:

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;

لماذا هذا الإعداد مهم لبوابات الموردين:

  • إدخال تدفق: المستند المحول من تدفق لا يمتلك مجلدًا، لذا لا يمكن لإشارة نسبية داخله أن تُحل إلى ملف مورد آخر.
  • ExternalResourceHandler: لا يزال يُنفَّذ لكل مورد، لذا تحتفظ بسجل دقيق لما طلبه كل تحميل من المورد.

الخطوة 3 - تنفيذ وإرفاق أصل مُراجَع

شعار المورد هو أحد الإشارات التي قد ترغب فعليًا في الاحتفاظ بها – يُزوَّد من نسخة تتحكم فيها، لا تُجلب من URL الخاص بالمورد:

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 من عنوان URL المطلوب مقابل القاموس الخاص بالأصول الموثوقة؛ عندما يتطابق، يضع ExternalResourceLoadingArgs.Data إلى البايتات المحلية ويضبط Skipped إلى false، لذا يظهر الشعار في PDF الناتج بينما تُحَجَب باقي الإشارات الخمسة في الفاتورة.

الخطوة 4 - رفض إدخال قائمة بيضاء غير مُكوَّن بشكل صحيح مبكرًا

إدخال قائمة بيضاء يكون مجرد اسم مضيف، وليس بادئة URI مطلقة، يؤدي إلى فشل التحويل بدلاً من المطابقة الصامتة الزائدة:

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 بدلاً من https://cdn.example.com/brand/ يُطلق InvalidLoadOptionsException بالرسالة: 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/'. التقاط هذا أثناء التحويل، في مراجعة التكوين أو فحص بدء التشغيل، أرخص بكثير من اكتشافه من مورد تم مطابقته خطأً في الإنتاج. احرص على اكتشافه قبل النشر.

لماذا قد يُرفض إدخال URL في القائمة البيضاء؟

WhitelistedResources تقبل فقط بادئات URI مطلقة، مثل https://cdn.example.com/brand/ أو file:///C:/assets/. الإصدارات السابقة كانت تُطابق الإدخال في أي موضع داخل URL، لذا كان cdn.example.com يطابق أيضًا عنوان المهاجم الذي يحتوي فقط على تلك الكلمات. منذ الإصدار 26.10 يُرفض هذا الإدخال مع InvalidLoadOptionsException، وتطبع الطريقة الأخيرة في العينة الرسالة الدقيقة.

مرفقات SVG للمورد تحمل نفس الخطر

رسم مرافق مرفق بفاتورة بناء لا يزال مجرد ملف SVG، ويُعالج عبر SvgLoadOptions بدلاً من WebLoadOptions. نفس العقدة، عنصر مختلف: ExternalResourceHandler يُطبق على إشارات <image> كما كان يُطبق على وسوم <img> في الفاتورة، وأي <script> مضمّن في الرسم لا يُنفَّذ:

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;

هذا هو بالضبط سيناريو فاتورة البناء من المقدمة: رسم يبدو كخطة طابق يمكنه أيضًا حمل إشارة إلى نقطة نهاية بيانات التعريف السحابية، ملف محلي، أو خادم المهاجم. في العينة العاملة تُحَجَب الثلاثة، وتظهر التسمية التوضيحية كما هي مرسومة، لأن السكريبت المرفق لا يُنفَّذ أبدًا.

السلوك قبل وبعد

الفحص التحويل مباشرةً من المسار المحفوظ هذا النهج
ملف شقيق في نفس المجلد يُحمَّل تلقائيًا محجوب – إدخال التدفق يزيل مجلد القاعدة
شعار المورد محجوب؛ يظهر PDF نصه البديل فقط يُزوَّد من ملف محلي مُراجَع
بيانات التعريف السحابية / عنوان داخلي محجوب افتراضيًا محجوب افتراضيًا
إدخال قائمة بيضاء باسم مضيف فقط مرفوض بـ InvalidLoadOptionsException مرفوض بنفس الطريقة، يُلتقط في فحص بدء التشغيل
سكريبت مضمّن في التحميل لا يُنفَّذ لا يُنفَّذ

تغيّر صفان: الشعار والملف الشقيق. الملف الشقيق هو ما لن يلتقطه فحص على مستوى الشبكة، لأنه لا يتضمن طلب شبكة.

سيناريوهات مستندات مورد أخرى حيث ينطبق ذلك

خاصية ExternalResourceHandler نفسها موجودة في خيارات التحميل لعدة صيغ أخرى تقبلها بوابات الموردين، لذا النمط أعلاه ليس محصورًا على HTML و SVG فقط:

  • مرفقات Word أو Excel مقدمة من المورد: WordProcessingLoadOptions و SpreadsheetLoadOptions ي expose نفس عقدة المعالج.
  • فواتير مُرسَلة بالبريد الإلكتروني: EmailLoadOptions ي expose نفس المعالج للصور البعيدة التي يشير إليها جسم البريد.
  • إيداعات مالية XBRL: FinanceLoadOptions يغطي إشارات التصنيف في مستندات XBRL المقدمة من المورد.

البدء في خط أنابيب تحميل المورد الخاص بك

لقد رأيت كيف يتعامل GroupDocs.Conversion مع تحميلات المورد غير الموثوقة بأمان. ما عليك فعله الآن:

الموارد