يبدأ العديد من المطورين بالبحث عن مكتبات مكونات واجهة المستخدم عندما يحتاجون إلى عرض المستندات في تطبيق ويب. Doconut Viewer هو مجموعة تطوير برمجيات .NET لإضافة عرض المتصفح بدون إضافات إلى مشاريع ASP.NET Core أو MVC أو WebForms الكلاسيكية. لا يزال الأمان يعتمد على بنية التطبيق الكاملة: المصادقة، التفويض، النقل، التخزين، التحقق، التنظيف، التصحيح، والمراقبة.

عارض مستندات ASP.NET الآمن محمي بواسطة ضوابط تطبيق متعددة الطبقات

1. تثبيت مجموعة تطوير Doconut App وإعداد مشروع .NET الخاص بك لتعدد صيغ الملفات

1.1 إضافة الحزمة المدعومة

استخدم الحزمة الحالية وتعليمات الإعداد من صفحة تنزيل Doconut الرسمية. سجّل الإصدار المختار وتأكد من أنه يدعم بيئة تشغيل .NET المستهدفة.

1.2 التحقق من مرجع الحزمة

بعد التثبيت، أكد مرجع الحزمة والإصدار المحلول في ملف المشروع. الحفاظ على الإصدارات صريحة يساعد في جعل عمليات البناء والنشر قابلة للتكرار.

1.3 تمكين HTTPS

يتطلب Doconut App بروتوكول SSL لجميع عمليات تحميل الملفات. تأكد من أن تطبيقك يستمع عبر HTTPS. لتطبيق مستضاف على Kestrel، أضف تكوين نقطة النهاية في appsettings.json:

 {
   "Kestrel": {
     "Endpoints": {
       "Https": {
         "Url": "
       }
     }
   }
 }

إذا كنت تستضيف على IIS، اربط شهادة HTTPS بالموقع. مع تمكين HTTPS، ينتقل كل ملف عبر قناة آمنة قبل الوصول إلى محرك عرض Doconut App.

لماذا Doconut App؟
Doconut App هو العارض الوحيد الأصلي لـ .NET الذي يجمع بين العرض بدون إضافات وتشفير AES‑256 من الطرف إلى الطرف، مما يتيح لك تلبية متطلبات الامتثال دون إضافة بنية تحتية إضافية.

2. تكوين تحميلات الملفات الآمنة والتخزين لإدارة المستندات

نموذج أمان Doconut App يعتمد على ثلاثة أعمدة: نقل SSL، تشفير AES‑256 أثناء التخزين، والحذف التلقائي بعد العرض. توفر مجموعة التطوير خدمة جاهزة يمكنك تسجيلها في تطبيقك.

2.1 تسجيل خدمة التحميل

في Startup.cs (أو Program.cs لـ .NET 6+)، أضف خدمات Doconut إلى حاوية حقن الاعتمادية. قم بتكوين مجلد تخزين مؤقت، فعّل تشفير AES‑256، وحدد فترة الحذف التلقائي (مثلاً، 10 دقائق بعد عرض المستند).

2.2 إنشاء نقطة نهاية التحميل

نفّذ إجراءً في المتحكم يستقبل ملفًا مرفوعًا، يمرره إلى خدمة Doconut للتخزين الآمن، ويعيد رمزًا قصيرًا لمرة واحدة. هذا الرمز هو ما سيستخدمه عارض الجانب العميل لجلب وعرض المستند.

2.3 حماية نقطة النهاية

نظرًا لأن نقطة نهاية التحميل تتعامل مع بيانات حساسة، احمها بالمصادقة وتفويض مبني على الأدوار (مثلاً، فقط المستخدمون في دور DocumentViewer يمكنهم التحميل). يضمن ذلك أن الأشخاص المصرح لهم فقط يمكنهم تخزين وعرض المستندات السرية.

ميزة Doconut App: تتولى مجموعة التطوير التعامل مع التشفير والتنظيف نيابةً عنك، لذا لن تحتاج أبدًا إلى كتابة شفرة تشفير مخصصة أو القلق بشأن الملفات اليتيمة.

3. تضمين مكوّن العارض في ASP.NET Core أو MVC أو WebForms

مع جاهزية الخلفية، قم بتهيئة العارض باستخدام الأصول وواجهة برمجة التطبيقات الموثقة للإصدار المثبت من Doconut.

3.1 إضافة حزمة JavaScript

في التخطيط المشترك، أدرج فقط موارد العارض الموضحة في الوثائق التي تتطابق مع مجموعة التطوير المثبتة. لا تفترض أسماء حزم ثابتة أو مواقع عبر الإصدارات.

3.2 إنشاء عرض Razor لـ Core/MVC

أضف عرضًا (مثلاً Views/Document/View.cshtml) يحتوي على حقل إدخال ملف، عنصر حاوية للعارض، وسكريبت صغير يرفع الملف المحدد، يستقبل الرمز الآمن، ويُهيئ عنصر Doconut Viewer.

التقاط الملف المحدد من عنصر <input type="file">.
إرسال الملف إلى نقطة نهاية التحميل باستخدام fetch أو XMLHttpRequest.
عند وصول الاستجابة المصرح بها، تهيئة العارض باستخدام واجهة برمجة التطبيقات المدعومة للإصدار المثبت.

3.3 ما يعادل WebForms

في صفحة WebForms (مثلاً DocumentViewer.aspx), ضع عنصر تحكم asp:FileUpload، زرًا لتفعيل التحميل، و <div> سيستضيف العارض. في الكود الخلفي، استدعِ خدمة Doconut لتخزين الملف المرفوع، احصل على الرمز، وسجّل سكريبت بدء تشغيل يستدعي دالة JavaScript (initViewer(token)) لإنشاء نسخة العارض.

فائدة Doconut App: عنصر JavaScript واحد، ثلاثة نماذج واجهة .NET، ولا مكتبات إضافية. البساطة في أبهى صورها.

4. تخصيص العارض لإدارة المستندات

من دون أي تعديل، يوفر Doconut Viewer شريط أدوات نظيف، أدوات تكبير/تصغير، ومفتاح تبديل بين الوضع الفاتح/الداكن. يمكنك تخصيص واجهة المستخدم لتتناسب مع علامتك التجارية ولأنواع المستندات المحددة.

4.1 تكوين شريط الأدوات

عند تهيئة العارض، يمكنك تحديد أي عناصر شريط الأدوات يجب أن تكون مرئية (مثلاً download، print، zoomIn، zoomOut، fullScreen). إزالة زر download، على سبيل المثال، يمنع المستخدمين من حفظ الملف الأصلي.

4.2 السمة والألوان

عيّن خيار theme إلى 'dark' أو 'light' ويمكنك اختيارياً توفير primaryColor الذي يتماشى مع لوحة ألوان شركتك. يحترم العارض متغيرات CSS، مما يسمح بتنسيق أعمق عبر ورقة أنماط مخصصة.

4.3 أدوات خاصة بـ CAD

إذا كنت تعرض ملفات DWG أو DXF أو DGN، فعّل خيارات CAD enableMeasurement و enableLayerToggle. يضيف ذلك أدوات قياس المسافة والزاوية والمساحة بالإضافة إلى لوحة إظهار/إخفاء الطبقات مباشرة في شريط الأدوات.

4.4 التعريب

مرّر رمز locale (مثلاً 'fr' للفرنسية) أثناء التهيئة. جميع سلاسل واجهة المستخدم، تلميحات الأدوات، ورسائل الخطأ ستُعرض باللغة المختارة.

لماذا التخصيص؟ يتيح لك Doconut App الحفاظ على مظهر العارض كامتداد طبيعي لموقعك مع الاستمرار في تقديم تجربة آمنة وخالية من الإضافات.

5. اختبار التكامل عبر جميع الصيغ المدعومة

قبل الإطلاق، أجرِ فحصًا سريعًا لكل نوع ملف تتوقع أن يقوم مستخدموك بعرضه. باستخدام عارض Doconut App، افتح ملفًا تجريبيًا لكل صيغة وتحقق من أن العرض، التنقل، وأي أدوات متخصصة تعمل كما هو موصوف.

الصيغة	سيناريو الاختبار	النتيجة المتوقعة
PDF	تقرير كبير متعدد الصفحات مع صور مدمجة	تمرير سلس، تكبير، وعرض ألوان دقيقة
DOCX	مستند Word يحتوي على جداول وهوامش	جميع النصوص والجداول والهوامش مرئية؛ لا حدوث تغير في التخطيط
XLSX	جدول بيانات يحتوي على مخططات	المخططات تُعرض كرسوميات متجهة؛ التكبير يحافظ على الوضوح
PPTX	مجموعة شرائح مع معاينة ثابتة	الشريحة الأولى تُعرض بشكل صحيح؛ لا توجد موارد مكسورة
DWG	رسم تقني متعدد الطبقات	تبديل الطبقات، أدوات القياس تعمل، الخطوط تبقى حادة
PSD	ملف Photoshop يحتوي على طبقات	الطبقات مرئية، الألوان دقيقة، التكبير يبقى حادًا
SVG	رسمة متجهة مع تدرجات لونية	التدرجات تُعرض بسلاسة؛ التكبير يبقى حادًا
TIFF	مسح عالي الدقة	الصورة تُحمّل بسرعة؛ التكبير يكشف التفاصيل

المرور عبر هذه القائمة باستخدام Doconut App يضمن أن كل صيغة مدعومة تعمل بشكل موثوق لمستخدميك.

الخلاصة

إدماج عارض مستندات آمن وخالٍ من الإضافات أصبح الآن بسيطًا مع Doconut App. باتباع الخطوات السابقة—تثبيت مجموعة التطوير، تكوين التحميلات المشفرة، تضمين عنصر JavaScript الخفيف، وتخصيص واجهة المستخدم—يمكنك تقديم عرض مستندات سريع وعالي الجودة عبر تطبيقات ASP.NET Core و MVC و WebForms.

هل أنت مستعد لتقييمه؟ ابدأ بـ صفحة تنزيل وتوثيق Doconut الرسمية، ثم اختبر مجموعة التطوير ضمن نفس مراجعة الأمان المطبقة على بقية تطبيق ASP.NET القائم على Windows.