Багато розробників починають шукати бібліотеки UI‑компонентів, коли їм потрібно відображати документи у веб‑додатку. Doconut Viewer — це .NET SDK для додавання безплагінного перегляду в браузері в проекти ASP.NET Core, MVC або класичні WebForms. Безпека все ще залежить від повної архітектури застосунку: автентифікація, авторизація, транспорт, зберігання, валідація, очищення, виправлення та моніторинг.
1. Встановіть SDK Doconut App та підготуйте ваш .NET проєкт для кількох форматів файлів
1.1 Додайте підтримуваний пакет
Використайте поточний пакет та інструкції з офіційної сторінки завантаження Doconut. Зафіксуйте обрану версію та переконайтеся, що вона підтримує цільове середовище виконання .NET.
1.2 Перевірте посилання на пакет
Після встановлення підтвердіть посилання на пакет і визначену версію у файлі проєкту. Явне зазначення версій допомагає робити збірки та розгортання відтворюваними.
1.3 Увімкніть HTTPS
Обслуговуйте застосунок через HTTPS, щоб завантажені документи не передавалися у відкритому вигляді у вашій мережі. Для застосунку, що працює на Kestrel, додайте конфігурацію кінцевої точки у appsettings.json:
{
"Kestrel": {
"Endpoints": {
"Https": {
"Url": "
}
}
}
}
Якщо ви розгортаєте на IIS, прив'яжіть до сайту сертифікат HTTPS. При увімкненому HTTPS файл передається через захищений канал до вашого сервера, де SDK його рендерить.
Звідки береться безпека. SDK працює всередині вашого застосунку, на вашій інфраструктурі: він не робить запитів до серверів Doconut, тому документи ніколи не залишають вашу мережу. Це властивість, навколо якої варто будувати дизайн. Це не сертифікат відповідності — SDK не постачається з ISO 27001, SOC 2 або HIPAA атестацією, і не може надати її вашому застосунку. Те, що він робить, — тримає файл у межах, які ви вже контролюєте та аудитуете.
2. Налаштуйте безпечне завантаження файлів та зберігання для управління документами
Це частина, яка належить вам, а не SDK, і варто сказати це відверто: безпека транспорту, шифрування даних у спокої, зберігання та очищення — це рішення вашого застосунку. SDK рендерить документи; він не є шаром зберігання і не шифрує ваш диск за вас.
2.1 Зареєструйте сервіси
У Startup.cs (або Program.cs у сучасному .NET) зареєструйте сервіси Doconut у контейнері впровадження залежностей згідно з документацією для встановленої версії. Там, де SDK потребує робочої папки для тимчасових результатів рендерингу, вкажіть місце, яким ви керуєте, і візьміть на себе відповідальність за очищення цієї папки — заплановане завдання або кероване застосунком життєвий цикл, а не припущення.
2.2 Створіть кінцеву точку завантаження
Реалізуйте дію контролера, яка приймає завантажений файл, записує його у сховище, яке вже використовує ваш застосунок, і повертає короткий одноразовий токен. Токен використовується клієнтським переглядачем для отримання та рендерингу документа. Зауважте, що зберігання — це ваша відповідальність: ви передаєте SDK байти або шлях, коли настав час рендерингу, а SDK повертає вам сторінки.
2.3 Захистіть кінцеву точку
Оскільки кінцева точка завантаження працює з конфіденційними даними, захистіть її автентифікацією та авторизацією за ролями (наприклад, лише користувачі з роллю DocumentViewer можуть завантажувати). Перевіряйте розширення та розмір файлу на сервері та в браузері, і розглядайте завантажені байти як недовірений ввід.
Не пропускайте це, припускаючи, що SDK це покриває. Шифрування даних у спокої, управління ключами та очищення залишкових файлів — це завдання вашого застосунку. Якщо вам потрібне шифрування документів на диску, використовуйте платформені засоби, яким ви вже довіряєте — переглядач не призначений для цього.
3. Вбудуйте компонент переглядача в ASP.NET Core, MVC або WebForms
Після підготовки бекенду ініціалізуйте переглядач, використовуючи ресурси та API, задокументовані для встановленої версії Doconut.
3.1 Додайте JavaScript‑пакет
У вашому спільному макеті включіть лише ті ресурси переглядача, які описані в документації, що відповідає встановленому SDK. Не припускайте, що назви чи розташування пакетів залишаються незмінними між версіями.
3.2 Створіть Razor‑вид для Core/MVC
Додайте вигляд (наприклад, Views/Document/View.cshtml), який містить елемент введення файлу, контейнер для переглядача та невеликий скрипт, що завантажує вибраний файл, отримує захищений токен і ініціалізує віджет Doconut Viewer.
Скрипт має:
- Захопити вибраний файл із елемента
<input type="file">. - Відправити файл на кінцеву точку завантаження за допомогою
fetchабоXMLHttpRequest. - Коли надійде авторизована відповідь, ініціалізувати переглядач, використовуючи підтримуване API встановленої версії.
3.3 Еквівалент для WebForms
У сторінці WebForms (наприклад, DocumentViewer.aspx) розмістіть елемент asp:FileUpload, кнопку для запуску завантаження та <div>, який буде хостити переглядач. У код‑бекенді викличте сервіс Doconut для збереження завантаженого файлу, отримайте токен і зареєструйте скрипт запуску, який викликає JavaScript‑функцію (initViewer(token)) для створення екземпляра переглядача.
Причина такої реалізації: один шлях рендерингу, що обслуговує три UI‑моделі .NET, без необхідності встановлювати щось на комп’ютері кінцевого користувача.
4. Налаштування переглядача для управління документами
Переглядач відображається всередині контейнера на вашій сторінці, тому оточуючий застосунок вже ваш. Окрім цього, беріть назви параметрів і їхні значення за документацією саме тієї версії, яку ви встановили, а не з будь‑якого підручника, включаючи цей. Поверхня конфігурації змінюється між випусками, і жорстко закодована назва параметра – це найчастіша причина поломки після оновлення.
Що варто вирішити заздалегідь:
4.1 Які елементи управління отримує користувач
Визначте, чи користувачі можуть завантажувати оригінальний файл, чи лише переглядати відрендерені сторінки. Кероване друкування входить до складу переглядача, а не є окремою покупкою, тому правила друку – це питання конфігурації, а не ліцензування.
4.2 Які плагіни дійсно потрібні
Чотири плагіни ліцензуються окремо, і їх список досить короткий, щоб його запам’ятати: Annotation, Converter, DICOM і Search. Конвертація – DOC у PDF та інше – реалізується плагіном Converter. Пошук тексту – плагін Search. Якщо вам не потрібен жоден з них, не купуйте їх.
4.3 Локалізація
Якщо ваш застосунок багатомовний, перевірте, які рядки інтерфейсу переглядача доступні у встановленій версії, перш ніж розробляти власну локалізацію.
Чому це важливо: переглядач має виглядати частиною вашого продукту. Він не повинен тихо обіцяти користувачам функції, які не входять у придбану ліцензію.
5. Перевірте інтеграцію для всіх підтримуваних форматів
Перед запуском у продакшн виконайте швидку перевірку кожного типу файлів, які ваші користувачі мають переглядати. За допомогою переглядача Doconut App відкрийте зразок файлу кожного формату і переконайтеся, що рендеринг, навігація та спеціалізовані інструменти працюють згідно опису.
| Формат | Сценарій тесту | Очікуваний результат |
|---|---|---|
| Великий багатосторінковий звіт із вбудованими зображеннями | Плавна прокрутка, масштабування та точна передача кольорів | |
| DOCX | Word‑документ з таблицями та виносками | Весь текст, таблиці та виноски видимі; без зміщення розмітки |
| XLSX | Таблиця з діаграмами | Діаграми відображаються як векторна графіка; масштабування зберігає чіткість |
| PPTX | Презентація з анімованими збірками | Кожна збірка на слайді відображається згрупованою в один кадр – це очікувано, а не помилка |
| DWG | Технічний креслення з шарами та зовнішніми посиланнями | Перемикання шарів, вимірювання відстані та площі працює; зовнішні посилання та шрифти SHX відсутні, бо їх не було у файлі |
| PSD | Багатошаровий файл Photoshop | Збережений композит відображається, приховані шари залишаються прихованими; кольори зберігаються при масштабуванні |
| SVG | Векторна графіка з градієнтами | Градієнти рендеряться плавно; масштабування залишається різким |
| TIFF | Високодетальний скан | Зображення завантажується швидко; масштабування розкриває деталі |
Тестуйте реальні файли ваших користувачів, а не чисті зразки. Формати, які здивують людей, зазвичай мають власні «диковинки» – DWG, що посилається на інші креслення, таблиця, у якій значення ніколи не переобчислювалися, або презентація без вбудованих шрифтів. Безкоштовний переглядач на Doconut.app працює на тому ж рушії, тому це швидкий спосіб побачити, як конкретний складний файл виглядатиме, перш ніж писати код.
Висновок
Вбудовування переглядача документів без плагінів зводиться до чотирьох речей: встановити SDK, забезпечити власний шлях завантаження, відобразити у контейнері на вашій сторінці та налаштувати лише те, що документує встановлена версія. Внесок переглядача у безпеку вузький, але реальний — він працює на ваших серверах і нічого не надсилає назовні. Все інше у цьому списку — це ваша програма, і жоден SDK не може це зробити за вас.
Готові оцінити його? Почніть з офіційної сторінки завантаження та документації Doconut, а потім протестуйте SDK у тому ж процесі перевірки безпеки, що застосовується до решти вашого Windows‑базованого ASP.NET застосунку.