Mnoho vývojářů začíná hledat knihovny UI komponent, když potřebují v webové aplikaci zobrazovat dokumenty. Doconut Viewer je .NET SDK pro přidání prohlížení v prohlížeči bez pluginů do projektů ASP.NET Core, MVC nebo klasických WebForms. Bezpečnost stále závisí na celé architektuře aplikace: autentizaci, autorizaci, přenosu, úložišti, validaci, úklidu, aktualizacích a monitorování.

Zabezpečený prohlížeč dokumentů ASP.NET chráněný vrstvenými kontrolami aplikace

1. Instalace SDK Doconut App a příprava vašeho .NET projektu pro více formátů souborů

1.1 Přidání podporovaného balíčku

Použijte aktuální balíček a instrukce nastavení z oficiální stránky ke stažení Doconut. Zaznamenejte zvolenou verzi a ověřte, že podporuje cílový .NET runtime.

1.2 Ověření reference na balíček

Po instalaci potvrďte referenci na balíček a vyřešenou verzi v souboru projektu. Udržování explicitních verzí pomáhá zajistit reprodukovatelnost sestavení a nasazení.

1.3 Povolení HTTPS

Doconut App vyžaduje SSL pro všechny nahrávání souborů. Ujistěte se, že vaše aplikace naslouchá na HTTPS. Pro aplikaci hostovanou na Kestrel přidejte konfiguraci koncového bodu do appsettings.json:

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

Pokud hostujete na IIS, přiřaďte webu certifikát HTTPS. S povoleným HTTPS každá soubor cestuje přes zabezpečený kanál, než dosáhne renderovacího enginu Doconut App.

Proč Doconut App? Doconut App je jediný .NET‑nativní prohlížeč, který kombinuje renderování bez pluginů s end‑to‑end šifrováním AES‑256, což vám umožní splnit požadavky na shodu bez přidání další infrastruktury.

2. Konfigurace zabezpečených nahrávání souborů a úložiště pro správu dokumentů

Bezpečnostní model Doconut App je založen na třech pilířích: SSL transport, šifrování AES‑256 v klidu a automatické mazání po zobrazení. SDK poskytuje připravenou službu, kterou můžete ve své aplikaci zaregistrovat.

2.1 Registrace služby pro nahrávání

V Startup.cs (nebo Program.cs pro .NET 6+) přidejte služby Doconut do kontejneru pro injekci závislostí. Nakonfigurujte dočasnou složku úložiště, povolte šifrování AES‑256 a nastavte interval automatického mazání (například 10 minut po zobrazení dokumentu).

2.2 Vytvoření koncového bodu pro nahrávání

Implementujte akci kontroleru, která přijme nahraný soubor, předá jej službě Doconut pro zabezpečené úložiště a vrátí krátký jednorázový token. Token je to, co klientská část prohlížeče použije k načtení a vykreslení dokumentu.

2.3 Ochrana koncového bodu

Protože koncový bod pro nahrávání pracuje s citlivými daty, chraňte jej pomocí autentizace a role‑založené autorizace (např. pouze uživatelé v roli DocumentViewer mohou nahrávat). To zajišťuje, že pouze oprávněný personál může ukládat a zobrazovat důvěrné dokumenty.

Výhoda Doconut App: SDK za vás provádí šifrování a úklid, takže nikdy nemusíte psát vlastní kryptografický kód ani se starat o opuštěné soubory.

3. Vložení komponenty prohlížeče do ASP.NET Core, MVC nebo WebForms

S připraveným backendem inicializujte prohlížeč pomocí aktiv a API zdokumentovaných pro nainstalovanou verzi Doconut.

3.1 Přidání JavaScript balíčku

Ve vašem sdíleném rozložení zahrňte pouze zdroje prohlížeče popsané v dokumentaci, která odpovídá nainstalovanému SDK. Nepředpokládejte pevné názvy balíčků nebo umístění napříč verzemi.

3.2 Vytvoření Razor view pro Core/MVC

Přidejte view (např. Views/Document/View.cshtml), která obsahuje vstup pro soubor, kontejnerový prvek pro prohlížeč a malý skript, který nahraje vybraný soubor, získá zabezpečený token a inicializuje widget Doconut Viewer.

Skript by měl:

Capturujte vybraný soubor z elementu <input type="file">.
Odešlete soubor na koncový bod nahrávání pomocí fetch nebo XMLHttpRequest.
Po přijetí autorizované odpovědi inicializujte prohlížeč pomocí podporovaného API pro nainstalovanou verzi.

3.3 Ekvivalent pro WebForms

Na stránce WebForms (např. DocumentViewer.aspx) umístěte ovládací prvek asp:FileUpload, tlačítko pro spuštění nahrávání a <div>, který bude hostovat prohlížeč. V kódu za stránkou zavolejte službu Doconut k uložení nahraného souboru, získáte token a zaregistrujete spouštěcí skript, který volá JavaScriptovou funkci (initViewer(token)) pro vytvoření instance prohlížeče.

Výhoda Doconut App: Jeden JavaScript widget, tři .NET UI modely, žádné další knihovny. Jednoduchost v nejvyšší podobě.

4. Přizpůsobení prohlížeče pro správu dokumentů

Po instalaci Doconut Viewer poskytuje čistý panel nástrojů, ovládání zoomu a přepínač světlého/tmavého motivu. Můžete přizpůsobit UI tak, aby odpovídalo vaší značce a konkrétním typům dokumentů.

4.1 Konfigurace panelu nástrojů

Při inicializaci prohlížeče můžete určit, které položky panelu nástrojů mají být viditelné (např. download, print, zoomIn, zoomOut, fullScreen). Odstranění tlačítka download například zabrání uživatelům ukládat původní soubor.

4.2 Motiv a barvy

Nastavte volbu theme na 'dark' nebo 'light' a volitelně poskytněte primaryColor, který odpovídá vaší firemní paletě. Prohlížeč respektuje CSS proměnné, což umožňuje podrobnější stylování pomocí vlastního stylesheetu.

4.3 Nástroje specifické pro CAD

Pokud zobrazujete soubory DWG, DXF nebo DGN, povolte CAD možnosti enableMeasurement a enableLayerToggle. To přidá nástroje pro měření vzdálenosti, úhlu a plochy a panel pro viditelnost vrstev přímo do panelu nástrojů.

4.4 Lokalizace

Při inicializaci předávejte kód locale (např. 'fr' pro francouzštinu). Všechny řetězce UI, tooltipy a chybové zprávy budou zobrazeny ve vybraném jazyce.

Proč přizpůsobovat? Doconut App vám umožní, aby prohlížeč vypadal jako přirozené rozšíření vašeho webu a přitom poskytoval stejný zabezpečený, bezpluginový zážitek.

5. Otestování integrace napříč všemi podporovanými formáty

Před nasazením do provozu proveďte rychlou kontrolu pro každý typ souboru, který očekáváte, že uživatelé budou zobrazovat. Pomocí prohlížeče Doconut App otevřete ukázkový soubor každého formátu a ověřte, že vykreslování, navigace a případné specializované nástroje fungují podle popisu.

Formát	Testovací scénář	Očekávaný výsledek
PDF	Velká, více‑stránková zpráva s vloženými obrázky	Plynulé rolování, zoom a přesné vykreslení barev
DOCX	Word dokument s tabulkami a poznámkami pod čarou	Veškerý text, tabulky a poznámky pod čarou jsou viditelné; žádné posuny rozložení
XLSX	Tabulka s grafy	Grafy se vykreslují jako vektorová grafika; při zoomu zůstává jasnost
PPTX	Prezentace se statickým náhledem	První snímek se zobrazuje správně; žádné poškozené zdroje
DWG	Technický výkres s více vrstvami	Přepínání vrstev, měření funguje, čáry zůstávají ostré
PSD	Photoshop soubor s vrstvami	Vrstvy jsou viditelné, barvy přesné, zoom zůstává ostrý
SVG	Vektorová grafika s přechody	Přechody se vykreslují plynule; zoom zůstává ostrý
TIFF	Vysoce rozlišený sken	Obrázek se načítá rychle; při zoomu se odhalují detaily

Procházení tohoto kontrolního seznamu s Doconut App zajišťuje, že každý podporovaný formát se pro vaše uživatele chová spolehlivě.

Závěr

Vložení zabezpečeného, bezpluginového prohlížeče dokumentů je nyní s Doconut App jednoduché. Dodržením výše uvedených kroků – instalací SDK, konfigurací šifrovaných nahrávání, vložením lehkého JavaScript widgetu a přizpůsobením UI – můžete poskytovat rychlé a vysoce kvalitní vykreslování dokumentů napříč aplikacemi ASP.NET Core, MVC a WebForms.

Jste připraveni jej vyzkoušet? Začněte na oficiální stránce ke stažení a dokumentaci Doconut, poté otestujte SDK v rámci stejného bezpečnostního přezkoumání, které se používá pro zbytek vaší Windows‑based ASP.NET aplikace.