Многие разработчики начинают поиск с библиотек UI‑компонентов, когда им нужно отображать документы в веб‑приложении. Doconut Viewer — это .NET SDK для добавления в браузер просмотра без плагинов в проекты ASP.NET Core, MVC или классические WebForms. Безопасность всё равно зависит от полной архитектуры приложения: аутентификации, авторизации, транспортировки, хранения, валидации, очистки, патчей и мониторинга.
1. Установите SDK 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 в состоянии покоя и автоматическое удаление после просмотра. SDK предоставляет готовый сервис, который можно зарегистрировать в приложении.
2.1 Зарегистрируйте сервис загрузки
В Startup.cs (или Program.cs для .NET 6+) добавьте сервисы Doconut в контейнер внедрения зависимостей. Настройте временную папку хранения, включите шифрование AES‑256 и задайте интервал автоматического удаления (например, 10 минут после просмотра документа).
2.2 Создайте конечную точку загрузки
Реализуйте действие контроллера, которое принимает загруженный файл, передаёт его сервису Doconut для безопасного хранения и возвращает короткий одноразовый токен. Этот токен будет использоваться клиентским просмотрщиком для получения и отображения документа.
2.3 Защитите конечную точку
Поскольку конечная точка загрузки работает с конфиденциальными данными, защитите её аутентификацией и авторизацией на основе ролей (например, только пользователи с ролью DocumentViewer могут загружать файлы). Это гарантирует, что только уполномоченный персонал может хранить и просматривать конфиденциальные документы.
Преимущество Doconut App: SDK самостоятельно обрабатывает шифрование и очистку, поэтому вам не придётся писать собственный криптографический код или беспокоиться о «осиротевших» файлах.
3. Встраивание компонента просмотрщика в ASP.NET Core, MVC или WebForms
С готовым бэкендом инициализируйте просмотрщик, используя ресурсы и API, описанные в документации установленной версии Doconut.
3.1 Добавьте JavaScript‑пакет
В общую разметку включите только те ресурсы просмотрщика, которые описаны в документации и соответствуют установленному SDK. Не делайте предположений о фиксированных именах пакетов или их расположении в разных версиях.
3.2 Создайте Razor‑view для 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)) для создания экземпляра просмотрщика.
Преимущество Doconut App: Один JavaScript‑виджет, три модели UI в .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' для французского) при инициализации. Все строки UI, подсказки и сообщения об ошибках будут отображаться на выбранном языке.
Зачем настраивать? Doconut App позволяет сохранить внешний вид просмотрщика как естественное продолжение вашего сайта, одновременно предоставляя тот же безопасный, не требующий плагинов опыт.
5. Тестирование интеграции со всеми поддерживаемыми форматами
Перед запуском в продакшн выполните быструю проверку каждого типа файла, который ожидаете показывать пользователям. С помощью просмотрщика Doconut App откройте образец файла каждого формата и убедитесь, что рендеринг, навигация и специализированные инструменты работают так, как описано.
| Формат | Сценарий теста | Ожидаемый результат |
|---|---|---|
| Большой многостраничный отчёт с встроенными изображениями | Плавная прокрутка, масштабирование и точное отображение цветов | |
| DOCX | Word‑документ с таблицами и сносками | Весь текст, таблицы и сноски видимы; без сдвига макета |
| XLSX | Электронная таблица с диаграммами | Диаграммы отображаются векторной графикой; при масштабировании сохраняется чёткость |
| PPTX | Презентация со статическим превью | Первая слайд отображается корректно; нет повреждённых ресурсов |
| DWG | Технический чертёж с несколькими слоями | Переключение слоёв, работа измерений, линии остаются чёткими |
| PSD | Файл Photoshop с слоями | Слои видимы, цвета точные, при масштабировании остаются резкими |
| SVG | Векторная графика с градиентами | Градиенты отображаются плавно; при масштабировании остаются резкими |
| TIFF | Скан высокого разрешения | Изображение загружается быстро; при масштабировании раскрываются детали |
Проведение этого чек‑листа с Doconut App гарантирует надёжную работу каждого поддерживаемого формата для ваших пользователей.
Заключение
Встраивание безопасного, не требующего плагинов просмотрщика документов теперь простое дело с Doconut App. Следуя описанным шагам — установке SDK, настройке зашифрованных загрузок, встраиванию лёгкого JavaScript‑виджета и кастомизации интерфейса — вы сможете обеспечить быструю и качественную отрисовку документов в приложениях ASP.NET Core, MVC и WebForms.
Готовы оценить решение? Начните с официальной страницы загрузки и документации Doconut, затем протестируйте SDK в рамках того же процесса проверки безопасности, который применяется к остальной части вашего Windows‑ориентированного ASP.NET‑приложения.