Wielu programistów zaczyna od poszukiwania bibliotek komponentów UI, gdy potrzebują wyświetlać dokumenty w aplikacji internetowej. Doconut Przeglądarka to zestaw SDK .NET umożliwiający dodanie bezwtyczkowego przeglądania w przeglądarce do projektów ASP.NET Core, MVC lub klasycznych WebForms. Bezpieczeństwo nadal zależy od pełnej architektury aplikacji: uwierzytelniania, autoryzacji, transportu, przechowywania, walidacji, czyszczenia, aktualizacji i monitorowania.

Bezpieczna przeglądarka dokumentów ASP.NET chroniona przez warstwowe kontrole aplikacji

1. Zainstaluj SDK Doconut App i przygotuj swój projekt .NET do obsługi wielu formatów plików

1.1 Dodaj obsługiwany pakiet

Użyj aktualnego pakietu oraz instrukcji konfiguracji z oficjalnej oficjalna strona pobierania Doconut. Zanotuj wybraną wersję i sprawdź, czy obsługuje docelowy runtime .NET.

1.2 Zweryfikuj odwołanie do pakietu

Po instalacji potwierdź odwołanie do pakietu oraz rozpoznaną wersję w pliku projektu. Utrzymywanie wersji w sposób jawny pomaga uczynić kompilacje i wdrożenia powtarzalnymi.

1.3 Włącz HTTPS

Doconut App wymaga SSL dla wszystkich przesyłanych plików. Upewnij się, że aplikacja nasłuchuje na HTTPS. Dla aplikacji hostowanej w Kestrel, dodaj konfigurację punktu końcowego w appsettings.json:

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

Jeśli hostujesz na IIS, powiąż certyfikat HTTPS z witryną. Po włączeniu HTTPS każdy plik przemieszcza się przez bezpieczny kanał przed dotarciem do silnika renderującego Doconut App.

Dlaczego Doconut App?
Doconut App jest jedyną natywną przeglądarką .NET, która łączy renderowanie bez wtyczek z szyfrowaniem end‑to‑end AES‑256, umożliwiając spełnienie wymogów zgodności bez dodawania dodatkowej infrastruktury.

2. Skonfiguruj bezpieczne przesyłanie plików i przechowywanie dla zarządzania dokumentami

Model bezpieczeństwa Doconut App opiera się na trzech filarach: transport SSL, szyfrowanie AES‑256 w spoczynku oraz automatyczne usuwanie po wyświetleniu. SDK udostępnia gotową usługę, którą możesz zarejestrować w swojej aplikacji.

2.1 Zarejestruj usługę przesyłania

W Startup.cs (lub Program.cs dla .NET 6+), dodaj usługi Doconut do kontenera wstrzykiwania zależności. Skonfiguruj tymczasowy folder przechowywania, włącz szyfrowanie AES‑256 i ustaw interwał automatycznego usuwania (na przykład 10 minut po wyświetleniu dokumentu).

2.2 Utwórz punkt końcowy przesyłania

Zaimplementuj akcję kontrolera, która odbiera przesłany plik, przekazuje go do usługi Doconut w celu bezpiecznego przechowywania i zwraca krótki jednorazowy token. Token jest używany przez przeglądarkę po stronie klienta do pobrania i renderowania dokumentu.

2.3 Zabezpiecz punkt końcowy

Ponieważ punkt końcowy przesyłania obsługuje wrażliwe dane, zabezpiecz go przy użyciu uwierzytelniania i autoryzacji opartej na rolach (np. tylko użytkownicy w roli DocumentViewer mogą przesyłać). Zapewnia to, że tylko upoważniony personel może przechowywać i przeglądać poufne dokumenty.

Zaleta Doconut App: SDK zajmuje się szyfrowaniem i czyszczeniem za Ciebie, więc nigdy nie musisz pisać własnego kodu kryptograficznego ani martwić się o porzucone pliki.

3. Osadź komponent przeglądarki w ASP.NET Core, MVC lub WebForms

Po przygotowaniu backendu zainicjuj przeglądarkę, korzystając z zasobów i API opisanych w dokumentacji pasującej do zainstalowanej wersji Doconut.

3.1 Dodaj pakiet JavaScript

W wspólnym układzie (layout) dołącz tylko zasoby przeglądarki opisane w dokumentacji pasującej do zainstalowanego SDK. Nie zakładaj stałych nazw pakietów ani ich lokalizacji w różnych wersjach.

3.2 Utwórz widok Razor dla Core/MVC

Dodaj widok (np. Views/Document/View.cshtml), który zawiera element wyboru pliku, kontener dla przeglądarki oraz mały skrypt, który przesyła wybrany plik, odbiera bezpieczny token i inicjalizuje widżet Doconut Viewer.

Skrypt powinien:

Pobierz wybrany plik z elementu <input type="file">.
Wyślij plik do punktu końcowego przesyłania używając fetch lub XMLHttpRequest.
Gdy otrzymasz autoryzowaną odpowiedź, zainicjuj przeglądarkę przy użyciu obsługiwane API zainstalowanej wersji.

3.3 Odpowiednik dla WebForms

W stronie WebForms (np. DocumentViewer.aspx) umieść kontrolkę asp:FileUpload, przycisk uruchamiający przesyłanie oraz <div>, który będzie hostował przeglądarkę. W kodzie zaplecza wywołaj usługę Doconut, aby przechować przesłany plik, uzyskać token i zarejestruj skrypt startowy, który wywołuje funkcję JavaScript (initViewer(token)) tworzącą instancję przeglądarki.

Korzyść z Doconut App: Jeden widżet JavaScript, trzy modele UI .NET, zero dodatkowych bibliotek. Prostota w najlepszym wydaniu.

4. Dostosuj przeglądarkę do zarządzania dokumentami

Po wyjęciu z pudełka Doconut Viewer oferuje czysty pasek narzędzi, kontrolki powiększania oraz przełącznik trybu jasny/ciemny. Możesz dostosować interfejs do swojej marki i konkretnych typów dokumentów.

4.1 Konfiguracja paska narzędzi

Podczas inicjalizacji przeglądarki możesz określić, które elementy paska narzędzi mają być widoczne (np. download, print, zoomIn, zoomOut, fullScreen). Usunięcie przycisku download uniemożliwia użytkownikom zapisanie oryginalnego pliku.

4.2 Motyw i kolory

Ustaw opcję theme na 'dark' lub 'light' i opcjonalnie podaj primaryColor, który pasuje do palety firmowej. Przeglądarka respektuje zmienne CSS, umożliwiając głębsze stylowanie za pomocą własnego arkusza stylów.

4.3 Narzędzia specyficzne dla CAD

Jeśli wyświetlasz pliki DWG, DXF lub DGN, włącz opcje CAD enableMeasurement i enableLayerToggle. Dodaje to narzędzia pomiaru odległości, kąta i powierzchni oraz panel widoczności warstw bezpośrednio w pasku narzędzi.

4.4 Lokalizacja

Przekaż kod locale (np. 'fr' dla francuskiego) podczas inicjalizacji. Wszystkie ciągi UI, podpowiedzi i komunikaty o błędach będą wyświetlane w wybranym języku.

Dlaczego dostosowywać? Doconut App pozwala zachować wygląd przeglądarki jako naturalne rozszerzenie Twojej witryny, jednocześnie zapewniając tę samą bezpieczną, bezwtyczkową obsługę.

5. Przetestuj integrację we wszystkich obsługiwanych formatach

Przed uruchomieniem produkcyjnym przeprowadź szybki test poprawności dla każdego typu pliku, który Twoi użytkownicy będą przeglądać. Korzystając z przeglądarki Doconut App, otwórz przykładowy plik każdego formatu i zweryfikuj, że renderowanie, nawigacja oraz specjalistyczne narzędzia działają zgodnie z opisem.

Format	Scenariusz testowy	Oczekiwany wynik
PDF	Duży, wielostronicowy raport z osadzonymi obrazami	Płynne przewijanie, powiększanie i dokładne odwzorowanie kolorów
DOCX	Dokument Word z tabelami i przypisami	Wszystkie teksty, tabele i przypisy widoczne; brak przesunięć układu
XLSX	Arkusz kalkulacyjny z wykresami	Wykresy renderowane jako grafika wektorowa; przy powiększeniu zachowują klarowność
PPTX	Prezentacja z podglądem statycznym	Pierwszy slajd wyświetla się poprawnie; brak uszkodzonych zasobów
DWG	Rysunek techniczny z wieloma warstwami	Przełączanie warstw, pomiary działają, linie pozostają ostre
PSD	Plik Photoshop z warstwami	Warstwy widoczne, kolory dokładne, przy powiększeniu ostre
SVG	Grafika wektorowa z gradientami	Gradienty renderują się płynnie; przy powiększeniu ostre
TIFF	Skan wysokiej rozdzielczości	Obraz ładuje się szybko; przy powiększeniu ujawnia szczegóły

Przejście przez tę listę kontrolną z Doconut App zapewnia, że każdy obsługiwany format zachowuje się niezawodnie dla Twoich użytkowników.

Zakończenie

Osadzenie bezpiecznej, bezwtyczkowej przeglądarki dokumentów jest teraz proste dzięki Doconut App. Postępując zgodnie z powyższymi krokami — instalacją SDK, konfiguracją zaszyfrowanych przesyłek, osadzeniem lekkiego widżetu JavaScript oraz dostosowaniem interfejsu — możesz dostarczyć szybkie, wysokiej jakości renderowanie dokumentów w aplikacjach ASP.NET Core, MVC i WebForms.

Gotowy, aby go ocenić? Zacznij od oficjalna strona pobierania i dokumentacji Doconut, a następnie przetestuj SDK w ramach tego samego przeglądu bezpieczeństwa stosowanego do reszty Twojej aplikacji ASP.NET działającej na Windows.