Mnoho vývojářů začíná hledáním knihoven UI komponent, když potřebují zobrazit dokumenty ve webové aplikaci. Doconut Viewer je .NET SDK pro přidání prohlížení v prohlížeči bez pluginu do projektů ASP.NET Core, MVC nebo klasických WebForms. Bezpečnost stále závisí na kompletní architektuře aplikace: autentizaci, autorizaci, transport, úložiště, validaci, úklid, opravy a monitorování.
1. Nainstalujte SDK Doconut App a připravte svůj .NET projekt na více formátů souborů
1.1 Přidejte podporovaný balíček
Použijte aktuální balíček a pokyny k nastavení z oficiální stahovací stránky Doconut. Zaznamenejte zvolenou verzi a ověřte, že podporuje cílový .NET runtime.
1.2 Ověřte odkaz na balíček
Po instalaci potvrďte odkaz na balíček a vyřešenou verzi v souboru projektu. Explicitní verze pomáhají učinit sestavení a nasazení reprodukovatelné.
1.3 Povolit HTTPS
Servírujte aplikaci přes HTTPS, aby nahrávané dokumenty necestovaly v čistém textu po síti. Pro aplikaci hostovanou na Kestrel přidejte konfiguraci koncového bodu v appsettings.json:
{
"Kestrel": {
"Endpoints": {
"Https": {
"Url": "
}
}
}
}
Pokud hostujete na IIS, připojte certifikát HTTPS k webu. S povoleným HTTPS soubor cestuje přes zabezpečený kanál na cestě k vašemu serveru, kde jej SDK vykreslí.
Odkud pochází zabezpečení.
SDK běží uvnitř vaší aplikace, na vaší infrastruktuře: neprovádí žádné volání na servery Doconut, takže dokumenty nikdy neopustí vaši síť. To je vlastnost, kolem které je třeba navrhovat. Nejedná se o certifikát shody — SDK neobsahuje žádné ISO 27001, SOC 2 ani HIPAA potvrzení a nemůže takové na vaši aplikaci udělit. Co dělá, je udržet soubor uvnitř hranice, kterou již kontrolujete a auditujete.
2. Nakonfigurujte zabezpečené nahrávání souborů a úložiště pro správu dokumentů
Toto je část, která patří vám, ne SDK, a stojí za to to říct jasně: zabezpečení transportu, šifrování v klidu, uchovávání a úklid jsou rozhodnutí, která vaše aplikace činí. SDK vykresluje dokumenty; není to úložná vrstva a nešifruje váš disk za vás.
2.1 Zaregistrujte služby
V Startup.cs (nebo Program.cs v moderním .NET) zaregistrujte služby Doconut v kontejneru pro injekci závislostí podle dokumentace pro verzi, kterou jste nainstalovali. Kde SDK potřebuje pracovní složku pro dočasný výstup renderování, nasměrujte ji někam, kde máte kontrolu, a úklid této složky převeďte na svou odpovědnost — naplánovaný úkol nebo životnost řízená aplikací, ne předpoklad.
2.2 Vytvořte koncový bod pro nahrávání
Implementujte akci kontroleru, která přijme nahraný soubor, zapíše jej do úložiště, které vaše aplikace již používá, a vrátí krátký jednorázový token. Token je to, co klientský prohlížeč použije k načtení a vykreslení dokumentu. Všimněte si, že ukládání je vaše: předáte SDK bajty nebo cestu, když je čas renderovat, a SDK vám vrátí stránky.
2.3 Chraňte koncový bod
Protože koncový bod pro nahrávání pracuje s citlivými daty, chraňte jej autentizací a autorizací na základě rolí (například pouze uživatelé v roli DocumentViewer mohou nahrávat). Ověřte příponu a velikost na serveru i v prohlížeči a považujte nahrané bajty za nedůvěryhodný vstup.
Neskačujte přes to s předpokladem, že SDK to pokrývá.
Šifrování v klidu, správa klíčů a úklid opuštěných souborů jsou úkolem vaší aplikace. Pokud potřebujete dokumenty šifrované na disku, použijte platformní prostředky, kterým již důvěřujete — prohlížeč není místem, kde by to mělo být.
3. Vložení komponenty Viewer do ASP.NET Core, MVC nebo WebForms
S připraveným backendem inicializujte viewer pomocí aktiv a API zdokumentovaného pro nainstalovanou verzi Doconut.
3.1 Přidání JavaScript balíčku
Ve svém sdíleném rozvržení zahrňte pouze zdroje vieweru popsané v dokumentaci, která odpovídá nainstalovanému SDK. Nepředpokládejte pevná jména balíčků ani umístění napříč verzemi.
3.2 Vytvoření Razor pohledu pro Core/MVC
Přidejte pohled (např. Views/Document/View.cshtml), který obsahuje vstup pro soubor, kontejnerový prvek pro viewer a malý skript, který nahrává vybraný soubor, získá zabezpečený token a inicializuje widget Doconut Viewer.
Skript by měl:
- Zachytit vybraný soubor z elementu
<input type="file">. - Odeslat soubor na koncový bod pro nahrávání pomocí
fetchneboXMLHttpRequest. - Když dorazí autorizovaná odpověď, inicializovat viewer 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 hostit viewer. V kódu‑behind zavolejte službu Doconut pro uložení nahraného souboru, získání tokenu a zaregistrujte spouštěcí skript, který volá JavaScriptovou funkci (initViewer(token)) pro vytvoření instance vieweru.
Důvod, proč to takto udělat: jedna cesta renderování obsluhující tři .NET UI modely, bez jakékoli instalace na počítači koncového uživatele.
4. Přizpůsobení Vieweru pro správu dokumentů
Viewer se vykresluje uvnitř kontejneru na vaší vlastní stránce, takže okolní aplikace je již vaše. Dále vezměte názvy možností a výchozí hodnoty z dokumentace pro verzi, kterou jste nainstalovali, místo z jakéhokoli tutoriálu, včetně tohoto – konfigurační rozhraní se mezi vydáními mění a pevně zakódovaný název možnosti je to, co nejčastěji selže při aktualizaci.
Věci, které stojí za to rozhodnout předem:
4.1 Jaké ovládací prvky uživatel získá
Rozhodněte, zda by vaši uživatelé měli mít možnost stáhnout originální soubor, nebo pouze číst vykreslené stránky. Řízený tisk je součástí vieweru, nikoli samostatný nákup, takže pravidla tisku jsou otázkou konfigurace, ne licencování.
4.2 Jaké pluginy skutečně potřebujete
Čtyři jsou licencovány samostatně a seznam je dostatečně krátký na to, aby si ho stálo zapamatovat: Annotation, Converter, DICOM a Search. Konverze – DOC na PDF a další – je plugin Converter. Textové vyhledávání je plugin Search. Pokud nepotřebujete žádný z nich, nekupujete žádný.
4.3 Lokalizace
Pokud je vaše aplikace vícejazyčná, zkontrolujte, co nainstalovaná verze nabízí pro řetězce UI vieweru, než na to navrhnete řešení.
Proč je to důležité: viewer by měl vypadat jako součást vašeho produktu. Neměl by tiše slibovat uživatelům funkce, které licence, kterou jste zakoupili, neobsahuje.
5. Otestování integrace napříč všemi podporovanými formáty
Před nasazením do provozu spusťte rychlou kontrolu pro každý typ souboru, který očekáváte, že vaši uživatelé budou prohlížet. Pomocí vieweru Doconut App otevřete ukázkový soubor každého formátu a ověřte, že vykreslování, navigace a jakékoli specializované nástroje fungují podle popisu.
| Formát | Testovací scénář | Očekávaný výsledek |
|---|---|---|
| Velká, vícestrá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é; nedochází k posunu rozvržení |
| XLSX | Tabulka s grafy | Grafy se vykreslují jako vektorová grafika; při zoomu zůstává jasnost |
| PPTX | Prezentace s animovanými sestavami | Každá sestava na snímku se vykreslí naskládaná v jednom rámci – to je očekávané, ne chyba |
| DWG | Technický výkres s vrstvami a externími odkazy | Vrstvy lze přepínat, měření vzdálenosti a plochy funguje; xrefy a SHX fonty chybí, protože v souboru nikdy nebyly |
| PSD | Vrstevnatý soubor Photoshop | Uložený kompozit se vykreslí, skryté vrstvy zůstávají skryté; barvy zůstávají při zoomu |
| SVG | Vektorová grafika s přechody | Přechody se vykreslují plynule; při zoomu zůstává ostrost |
| TIFF | Vysoce rozlišený sken | Obrázek se načítá rychle; při zoomu se odhalí detaily |
Testujte s reálnými soubory vašich uživatelů, ne s čistými ukázkami. Formáty, které lidi překvapují, jsou ty, jejichž zvláštnosti jsou v samotném formátu – DWG, který odkazuje na čtyři další výkresy, tabulka, jejíž uložené hodnoty nikdy nebyly přepočítány, prezentace, jejíž fonty nebyly vloženy. Bezplatný viewer na Doconut.app používá stejný engine, takže je to rychlý způsob, jak zjistit, jak konkrétní obtížný soubor vypadá, než napíšete jakýkoli kód.
Závěr
Vložení prohlížeče dokumentů bez pluginů se redukuje na čtyři věci: nainstalovat SDK, zabezpečit vlastní cestu pro nahrávání, vykreslit do kontejneru na vaší stránce a nakonfigurovat pouze to, co dokumentuje nainstalovaná verze. Přínos prohlížeče k bezpečnosti je úzký a reálný — běží na vašich serverech a nic neodesílá ven. Všechno ostatní na tomto seznamu je vaše aplikace a žádné SDK to za vás převzít nemůže.
Jste připraveni to vyhodnotit? Začněte na oficiální stránce ke stažení a dokumentaci Doconut, poté otestujte SDK ve stejném bezpečnostním přezkoumání, které se vztahuje na zbytek vaší Windows‑based ASP.NET aplikace.