بسیاری از توسعهدهندگان ابتدا به دنبال کتابخانههای مؤلفه UI میگردند وقتی نیاز به نمایش اسناد در یک برنامه وب دارند. نمایشگر Doconut یک SDK .NET برای افزودن نمایش مرورگر بدون افزونه به پروژههای ASP.NET Core، MVC یا WebForms کلاسیک است. امنیت همچنان به معماری کامل برنامه بستگی دارد: احراز هویت، مجوزدهی، انتقال، ذخیرهسازی، اعتبارسنجی، پاکسازی، بهروزرسانی و نظارت.
۱. نصب SDK برنامه Doconut و آمادهسازی پروژه .NET شما برای چندین فرمت فایل
۱.۱ افزودن بسته پشتیبانیشده
از بسته فعلی و دستورالعملهای راهاندازی موجود در صفحه دانلود Doconut استفاده کنید. نسخه انتخابی را ثبت کنید و اطمینان حاصل کنید که از زماناجرای هدف .NET پشتیبانی میکند.
۱.۲ تأیید ارجاع بسته
پس از نصب، ارجاع بسته و نسخه حلشده در فایل پروژه را تأیید کنید. نگهداشتن نسخهها بهصورت صریح به تولیدات و استقرارهای قابل تکرار کمک میکند.
۱.۳ فعالسازی HTTPS
Doconut App برای تمام بارگذاریهای فایل به SSL نیاز دارد. اطمینان حاصل کنید برنامه شما بر روی HTTPS گوش میدهد. برای برنامهای که توسط Kestrel میزبانی میشود، یک پیکربندی نقطهٔ انتهایی در appsettings.json اضافه کنید:
{
"Kestrel": {
"Endpoints": {
"Https": {
"Url": "
}
}
}
}
اگر بر روی IIS میزبانی میکنید، یک گواهینامه HTTPS به سایت متصل کنید. با فعالسازی HTTPS، هر فایل قبل از رسیدن به موتور رندرینگ Doconut App از یک کانال امن عبور میکند.
چرا Doconut App?
Doconut App تنها نمایشگر بومی .NET است که ترکیبی از رندرینگ بدون افزونه و رمزنگاری انتها به انتهای AES‑256 را فراهم میکند و به شما امکان میدهد الزامات انطباق را بدون افزودن زیرساختهای اضافی برآورده کنید.
۲. پیکربندی بارگذاری امن فایلها و ذخیرهسازی برای مدیریت اسناد
مدل امنیتی Doconut App بر پایهٔ سه ستون است: انتقال SSL، رمزنگاری AES‑256 در حالت استراحت، و حذف خودکار پس از مشاهده. SDK یک سرویس آمادهاست که میتوانید در برنامهتان ثبت کنید.
۲.۱ ثبت سرویس بارگذاری
در Startup.cs (یا Program.cs برای .NET 6+)، سرویسهای Doconut را به کانتینر تزریق وابستگی اضافه کنید. یک پوشهٔ ذخیرهسازی موقت پیکربندی کنید، رمزنگاری AES‑256 را فعال کنید و بازهٔ حذف خودکار را تنظیم کنید (بهعنوان مثال، ۱۰ دقیقه پس از مشاهدهٔ سند).
۲.۲ ایجاد نقطهٔ انتهایی بارگذاری
یک اکشن کنترلر پیادهسازی کنید که فایل بارگذاریشده را دریافت میکند، به سرویس Doconut برای ذخیرهسازی امن میسپارد و یک توکن یکبار مصرف کوتاه برمیگرداند. این توکن همان چیزی است که نمایشگر سمتکلاینت برای دریافت و رندر سند استفاده میکند.
۲.۳ محافظت از نقطهٔ انتهایی
از آنجا که نقطهٔ انتهایی بارگذاری با دادههای حساس سروکار دارد، آن را با احراز هویت و مجوزدهی مبتنی بر نقش (مثلاً فقط کاربران دارای نقش DocumentViewer میتوانند بارگذاری کنند) محافظت کنید. این اطمینان میدهد تنها افراد مجاز میتوانند اسناد محرمانه را ذخیره و مشاهده کنند.
مزیت Doconut App: SDK رمزنگاری و پاکسازی را برای شما مدیریت میکند، بنابراین دیگر نیازی به نوشتن کدهای سفارشی رمزنگاری یا نگرانی دربارهٔ فایلهای بیسرپرست ندارید.
۳. ادغام مؤلفهٔ نمایشگر در ASP.NET Core، MVC یا WebForms
با آماده بودن بکاند، نمایشگر را با داراییها و API مستند شده برای نسخهٔ نصبشدهٔ Doconut مقداردهی کنید.
۳.۱ افزودن باندل JavaScript
در قالب مشترک خود، فقط منابع نمایشگر را که در مستندات برای SDK نصبشده توصیف شدهاند، گنجانید. فرض نکنید نامها یا مکانهای باندل در نسخههای مختلف ثابت هستند.
۳.۲ ایجاد یک Razor view برای Core/MVC
یک view (مثلاً Views/Document/View.cshtml) اضافه کنید که شامل یک ورودی فایل، یک عنصر container برای نمایشگر و یک اسکریپت کوچک باشد که فایل انتخابشده را بارگذاری میکند، توکن امن را دریافت میکند و ویجت Doconut Viewer را مقداردهی میکند.
اسکریپت باید:
- فایل انتخابشده را از عنصر
<input type="file">دریافت کند. - فایل را به نقطهٔ انتهایی بارگذاری با استفاده از
fetchیاXMLHttpRequestبفرستد. - هنگامی که پاسخ معتبر دریافت شد، نمایشگر را با استفاده از API پشتیبانیشده برای نسخهٔ نصبشده مقداردهی کند.
۳.۳ معادل WebForms
در یک صفحه WebForms (مثلاً DocumentViewer.aspx)، یک کنترل asp:FileUpload، یک دکمه برای فراخوانی بارگذاری و یک <div> که نمایشگر را میزبانی میکند، قرار دهید. در کد‑پشت، سرویس Doconut را برای ذخیرهٔ فایل بارگذاریشده صدا بزنید، توکن را دریافت کنید و یک اسکریپت شروعکننده (initViewer(token)) را ثبت کنید تا نمونهٔ نمایشگر ایجاد شود.
مزیت Doconut App: یک ویجت JavaScript، سه مدل UI .NET، بدون کتابخانهٔ اضافی. سادگی در بهترین شکل ممکن.
۴. سفارشیسازی نمایشگر برای مدیریت اسناد
بهصورت پیشفرض، Doconut Viewer یک نوار ابزار تمیز، کنترلهای زوم و یک کلید تغییر تم روشن/تیره ارائه میدهد. میتوانید UI را برای هماهنگی با برند خود و انواع خاص سند تنظیم کنید.
۴.۱ پیکربندی نوار ابزار
هنگام مقداردهی نمایشگر، میتوانید موارد نوار ابزار قابل نمایش را مشخص کنید (مثلاً download, print, zoomIn, zoomOut, fullScreen). حذف دکمهٔ download بهعنوان مثال، مانع ذخیرهٔ فایل اصلی توسط کاربران میشود.
۴.۲ تم و رنگها
گزینهٔ theme را به 'dark' یا 'light' تنظیم کنید و بهصورت اختیاری یک primaryColor که با پالت سازمانی شما همراستا باشد، ارائه دهید. نمایشگر متغیرهای CSS را رعایت میکند و امکان استایلدهی عمیقتر از طریق یک stylesheet سفارشی را میدهد.
۴.۳ ابزارهای مخصوص CAD
اگر DWG، DXF یا DGN نمایش میدهید، گزینههای CAD enableMeasurement و enableLayerToggle را فعال کنید. این گزینهها ابزارهای اندازهگیری فاصله، زاویه و مساحت و همچنین پنل مشاهده لایهها را مستقیماً در نوار ابزار اضافه میکند.
۴.۴ بومیسازی (Localization)
در زمان مقداردهی یک کد locale (مثلاً 'fr' برای فرانسوی) ارسال کنید. تمام رشتههای UI، نکات ابزار و پیامهای خطا به زبان انتخابشده نمایش داده میشوند.
چرا سفارشیسازی؟ Doconut App به شما اجازه میدهد نمایشگر را طوری تنظیم کنید که گویی بخشی طبیعی از سایت شماست، در حالی که همچنان تجربهٔ امن و بدون افزونه را ارائه میدهد.
۵. تست یکپارچهسازی برای تمام فرمتهای پشتیبانیشده
قبل از راهاندازی، یک بررسی سریع برای هر نوع فایلی که انتظار دارید کاربران مشاهده کنند، انجام دهید. با استفاده از نمایشگر Doconut App، یک فایل نمونه از هر فرمت را باز کنید و اطمینان حاصل کنید که رندر، ناوبری و هر ابزار تخصصی مطابق توضیحات کار میکند.
| فرمت | سناریوی تست | نتیجهٔ مورد انتظار |
|---|---|---|
| گزارش بزرگ چندصفحهای با تصاویر توکار | اسکرول روان، زوم، و رندر رنگ دقیق | |
| DOCX | سند Word با جدولها و پاورقیها | تمام متن، جدولها و پاورقیها قابل مشاهده؛ بدون جابهجایی طرح |
| XLSX | صفحهگسترده با نمودارها | نمودارها بهصورت گرافیک برداری رندر میشوند؛ زوم وضوح را حفظ میکند |
| PPTX | ارائه اسلایدی با پیشنمایش ثابت | اسلاید اول بهدرستی نمایش داده میشود؛ داراییهای خراب نیستند |
| DWG | نقشه فنی با لایههای متعدد | لایهها قابل تغییر، ابزارهای اندازهگیری کار میکنند، خطوط واضح میمانند |
| PSD | فایل Photoshop با لایهها | لایهها قابل مشاهده، رنگها دقیق، زوم واضح میماند |
| SVG | گرافیک برداری با گرادیانها | گرادیانها بهصورت روان رندر میشوند؛ زوم واضح میماند |
| TIFF | اسکن با وضوح بالا | تصویر بهسرعت بارگذاری میشود؛ زوم جزئیات را نشان میدهد |
پیمایش این چکلیست با Doconut App اطمینان میدهد که هر فرمت پشتیبانیشده برای کاربران شما بهصورت قابل اطمینان رفتار میکند.
نتیجهگیری
ادغام یک نمایشگر سند امن و بدون افزونه اکنون با Doconut App ساده است. با پیروی از مراحل بالا—نصب SDK، پیکربندی بارگذاریهای رمزگذاریشده، ادغام ویجت سبک JavaScript و سفارشیسازی UI—میتوانید رندر سریع و با کیفیت بالا را در برنامههای ASP.NET Core، MVC و WebForms ارائه دهید.
آمادهاید آن را ارزیابی کنید؟ ابتدا به صفحه دانلود و مستندات رسمی Doconut مراجعه کنید، سپس SDK را در همان بازبینی امنیتی که برای بقیه برنامهٔ Windows‑based ASP.NET خود اعمال میکنید، تست کنید.