Так—ви можете вбудувати захищений, безплагінний онлайн‑переглядач файлів у будь‑який застосунок ASP.NET Core, MVC або WebForms за кілька хвилин, і Doconut App виконує всю складну роботу.
Компанії, які працюють з контрактами, кресленнями чи дизайнерськими матеріалами, потребують переглядача, який дотримується корпоративних політик безпеки і ніколи не змушує користувачів встановлювати застарілі плагіни браузера. Doconut надає .NET SDK переглядача документів для браузерних робочих процесів PDF, Office, CAD, електронної пошти та зображень. У цьому дописі викладено рішення щодо інтеграції без використання прикладів коду, специфічних для конкретної версії.
1. Чому безпека та безплагінний рендеринг важливі для .NET веб‑додатків
Сучасні компанії розглядають кожен документ як потенційний витік даних. Коли ви вбудовуєте переглядач, який покладається на ActiveX, Flash або нативний клієнт, ви успадковуєте три ризики:
| Ризик | Вплив на ваш .NET застосунок | Як Doconut App усуває його |
|---|---|---|
| Залежність від плагінів | Користувачі повинні встановити або ввімкнути плагін браузера, що призводить до запитів у підтримку та проблем з відповідністю. | Doconut працює повністю в HTML5/Canvas, не вимагаючи жодних плагінів. |
| Нешифрований трансфер | Файли передаються по HTTP або зберігаються у відкритому вигляді, порушуючи GDPR, HIPAA або внутрішні політики. | Усі завантаження проходять через SSL і зберігаються з шифруванням AES‑256. |
| Неконтрольований життєвий цикл | Файли можуть залишатися на сервері, збільшуючи поверхню уразливості. | Doconut автоматично видаляє файли після перегляду, забезпечуючи короткий період зберігання. |
Оскільки переглядач постачається як JavaScript‑компонент, який спілкується з безпечним сервісом рендерингу Doconut, ваш .NET стек залишається чистим — без додаткових нативних бібліотек, сторонніх бінарних файлів та додаткових аудитів відповідності.
2. Підготовка .NET проекту
Використовуйте пакет, документацію та приклади, що відповідають обраній для проекту версії Doconut. Офіційна Сторінка завантаження Doconut є надійною відправною точкою.
Перед інтеграцією підтвердіть цільову .NET runtime, зафіксуйте версію пакету, тримайте конфігурацію ліцензії поза системою контролю версій і почніть з представницьких документів. ASP.NET Core, MVC і WebForms мають різні життєві цикли застосунків, тому їх налаштування не слід розглядати як ідентичні.
3. Створення захищеного кінцевого пункту завантаження – AES‑256, SSL та автоматичне видалення
Переглядач ніколи не отримує доступ до файлів безпосередньо у вашій файловій системі. Замість цього ви завантажуєте документ у тимчасове, зашифроване сховище, яке Doconut читає за запитом. Нижче — високорівневий опис необхідних кроків для ASP.NET Core; ті ж ідеї застосовуються до MVC і WebForms.
Робочий процес на сервері
- Прийняти завантажений файл – Використовуйте стандартний
IFormFile(абоHttpPostedFileу WebForms), щоб отримати документ від клієнта. - Зашифрувати файл за допомогою AES‑256 – Перед збереженням потоку зашифруйте його за допомогою перевіреної бібліотеки, наприклад
System.Security.Cryptography.Aes. Збережіть зашифрований блоб у безпечному місці (наприклад, Azure Blob Storage з увімкненим шифруванням на боці сервера або S3 bucket з SSE‑AES256). - Створити короткоживучий підписаний URL – Створіть URL, дійсний кілька хвилин (наприклад, 5 хвилин). URL має бути HTTPS і містити криптографічний токен, який Doconut може перевірити. Більшість провайдерів хмарного сховища пропонують функцію «pre‑signed URL», що підходить для цього.
- Повернути підписаний URL клієнту – Надішліть JSON‑відповідь, що містить URL. Клієнт передасть цей URL переглядачу Doconut.
- Запланувати автоматичне видалення – Після закінчення терміну дії підписаного URL фонове завдання (Hangfire, Azure Functions тощо) видаляє зашифрований блоб, гарантуючи, що файл не залишиться на сервері.
Еквіваленти для MVC / WebForms
- MVC – Розмістіть ту ж логіку у звичайному дії контролера та поверніть
JsonResult. - WebForms – Реалізуйте обробник
.ashxабо метод сторінки, який виконує ті ж кроки: отриматиRequest.Files[0], зашифрувати, створити pre‑signed URL і записати JSON‑відповідь.
Єдина різниця — синтаксис маршрутизації; робочий процес безпеки залишається ідентичним.
4. Відображення документа за допомогою встановленого SDK
Тримайте доступ до документу на сервері та забезпечте авторизацію перед обробкою файлу або потоку. Точна послідовність рендерингу та ініціалізації UI залежить від версії; слідуйте офіційній документації, що постачається разом із встановленою збіркою, а не копіюйте неперевірений глобальний JavaScript API.
Чому це працює для будь‑якого .NET варіанту
- ASP.NET Core Razor – Скрипт розташований у тому ж вигляді, який містить форму завантаження, тому процес безперервний.
- MVC – Використовуйте
@section Scriptsдля вставки того ж фрагмента; контролер повертає JSON, який може обробити$.ajaxу MVC. - WebForms – Зареєструйте скрипт за допомогою
ClientScript.RegisterStartupScriptпісля завершення завантаження, а потім викличтеlaunchViewerтак само.
Оскільки Doconut транслює документ безпосередньо з підписаного URL, сервер більше не торкається файлу після кроку завантаження. Переглядач рендерить PDF, Word, CAD‑креслення та інші формати, зазначені у технічних характеристиках продукту — без будь‑якого додаткового серверного конвертування.
5. Налаштування переглядача під ваш бренд – тонка настройка онлайн‑переглядача файлів
Компанії часто потребують, щоб переглядач виглядав як вбудована частина їх порталу. Повністю налаштовуваний інтерфейс Doconut App дозволяє:
| Налаштування | Як застосувати в .NET |
|---|---|
| Розташування панелі інструментів | Передайте toolbar: false і створіть власні кнопки, які викликають JavaScript‑API переглядача (наприклад, zoomIn(), print()). |
| Колірна схема | Встановіть theme: "dark" або підключіть власний CSS‑файл, який перевизначає стандартні класи. |
| Мова та доступність | Doconut враховує атрибут lang у контейнері; ви також можете додати ARIA‑мітки через параметр accessibility. |
| Події (hooks) | Колбеки типу onPageChange, onError і onDownload дозволяють записувати метрики використання у ваш існуючий телеметричний конвеєр. |
Усі ці hooks налаштовуються в тому ж JavaScript‑об’єкті, що був показаний у попередньому розділі. Оскільки переглядач працює повністю на клієнті, додаткового навантаження на сервер немає — ваш .NET бекенд залишається зосередженим на автентифікації, шифруванні та бізнес‑логіці.
6. Продуктивність та масштабованість – забезпечте швидку роботу
Вбудовування переглядача у високонавантажений портал піднімає два практичних питання: час завантаження та одночасний рендеринг. Doconut App вирішує обидва «з коробки», проте ви можете підвищити продуктивність за допомогою кількох .NET‑специфічних трюків.
| Питання | Вбудована перевага Doconut | Додаткова порада для .NET |
|---|---|---|
| Початкове завантаження | Скрипт переглядача важить лише ~150 KB у стисненому вигляді. | Увімкніть статичне стиснення файлів (app.UseResponseCompression()) і кешування (Cache‑Control: public, max‑age=31536000). |
| Потокове передавання файлів | Doconut транслює лише потрібні сторінки, використовуючи HTTP‑range запити. | Зберігайте зашифровані блоби у регіональному CDN (Azure Front Door, Amazon CloudFront), щоб знизити затримку. |
| Одночасні користувачі | Рендеринг відбувається на клієнті; сервер подає зашифрований файл лише один раз за перегляд. | Обмежте кінцеву точку завантаження за допомогою IApplicationRateLimiter, щоб захиститися від пікових навантажень. |
| Використання пам'яті | Немає серверних бібліотек конвертування PDF, тому процес ASP.NET залишається легким. | Запустіть сервіс завантаження у окремому мікросервісі, якщо у вас вже є важка черга фонових завдань. |
Дотримуючись цих рекомендацій, ви зможете підтримувати тисячі одночасних переглядачів, не розширюючи .NET веб‑шару за межі існуючої інфраструктури.
Основні висновки
- Doconut App надає безплагінний, 100 % захищений переглядач, який працює з ASP.NET Core, MVC та WebForms.
- Завантаження здійснюються лише через SSL, зберігаються з шифруванням AES‑256 і автоматично видаляються після закінчення терміну дії підписаного URL.
- Інтеграція вимагає лише скрипту CDN, контейнера
<div>та невеликої серверної кінцевої точки, що повертає підписаний URL. - Переглядач підтримує PDF, Office, CAD та понад 50 форматів зображень — без потреби у серверному конвертуванні.
- UI можна повністю налаштувати під корпоративний брендинг, а переглядач пропонує вбудовані інструменти масштабування, вимірювання та шарування для CAD‑файлів.
- Продуктивність обробляється на стороні клієнта; розробникам .NET потрібно лише забезпечити стискання статичних файлів та, за потреби, кешування через CDN.
- Увесь процес — від захищеного завантаження до рендерингу в браузері — безшовно вписується у існуючі .NET механізми автентифікації та авторизації.
Поширені питання
Q1: Чи потрібно встановлювати якісь пакети NuGet для використання Doconut?
A: Ні. Переглядач постачається як клієнтський JavaScript‑пакет з CDN Doconut. Ваш сервер потребує лише звичайного middleware ASP.NET Core для завантаження файлів та шифрування, який, швидше за все, вже є у вашому проєкті.
Q2: Як Doconut гарантує, що файл буде видалений після перегляду?
A: Doconut генерує короткоживучий підписаний URL, який закінчується через заданий період (зазвичай п’ять хвилин). Після закінчення терміну дії ви (або фонове завдання очищення) видаляєте зашифрований блоб. Це забезпечує, що документ не зберігається довше, ніж це необхідно, і відповідає суворим політикам зберігання даних.
Q3: Чи можу я використовувати переглядач для друку або експорту документа?
A: Так. Вбудована панель інструментів Doconut включає опції друку та експорту, які зберігають оригінальну якість і розмітку вихідного файлу.
Готові вбудувати захищений, безплагінний переглядач документів у вашу .NET‑аплікацію? Почніть з Doconut App вже сьогодні і доставляйте PDF, Office, CAD та десятки інших форматів безпечно та миттєво.