Návod: Bezpečné vložení Doconut Viewer pomocí React – End to End
Bezpečné vložení prohlížeče dokumentů vyžaduje více než jen zkopírování úryvku middleware do aplikace ASP.NET Core. Integrace musí definovat jasné hranice pro autentizaci, přístup k dokumentům, správu relací, vykreslování, anotace, vyhledávání, tisk a auditní logování.
Podniky budující portály zaměřené na dokumenty — jako jsou DMS, CRM, právní revize nebo aplikace pro technické výkresy — také potřebují uchovávat originální soubory za hranicí aplikace. Doconut podporuje server‑side model prohlížení PDF, Office, CAD a obrazových dokumentů, zatímco React front‑end může poskytnout uživatelské rozhraní.
Tento návod se zaměřuje na spolehlivou architekturu a úmyslně se vyhýbá názvům balíčků, vlastnostem možností, signaturám metod a cestám endpointů, které se mohou lišit mezi verzemi SDK. Použijte oficiální dokumentaci odpovídající vaší licencované verzi pro přesné informace o registraci a API.
1️⃣ Krok 1 – Připravte projekty ASP.NET Core a React
Než napíšete jakýkoli kód, ujistěte se, že vaše vývojové prostředí splňuje základní požadavky:
| Požadavek | Doporučená verze |
|---|---|
| .NET runtime | .NET 6 nebo novější |
| ASP.NET Core | 6.0+ |
| IDE | Podporované .NET vývojové prostředí |
| Front‑end (volitelný) | React aplikace kompatibilní s vaším projektem |
- Vytvořte nový ASP.NET Core Web API projekt
dotnet new webapi -n DocPortal
cd DocPortal
-
Přidejte licencované závislosti Doconut – Získejte přesné názvy balíčků, verze, nativní závislosti a instrukce pro načítání licence z oficiální dokumentace pro vaši verzi Doconut. Nepředpokládejte, že balíček nebo wrapper uvedený v nesouvisejícím tutoriálu platí pro vaši verzi.
-
Připravte React aplikaci – Pokud bude prohlížeč prezentován přes React, použijte front‑end nastavení již schválené vaším týmem. Udržujte React aplikaci závislou na vašem vlastním autentizovaném API místo na nedokumentovaných třetích stranách.
-
Zaznamenejte počáteční stav – Většina podnikových týmů vynucuje Git politiku, která vyžaduje podepsaný commit pro jakoukoli změnu týkající se licencí nebo bezpečnostních nastavení.
Nyní máte čisté řešení připravené pro dokumentovanou integraci Doconut serveru.
2️⃣ Krok 2 – Bezpečně nakonfigurujte serverovou integraci
Zaregistrujte prohlížeč podle instrukcí dodaných pro přesnou verzi Doconut ve vašem projektu. Pořadí middleware, registrace služeb, inicializace licence a názvy konfiguračních vlastností jsou specifické pro verzi a neměly by být kopírovány z neověřených příkladů.
Bez ohledu na verzi SDK by okolní aplikace ASP.NET Core měla vynucovat následující kontroly:
- Autentizujte před otevřením dokumentu – Relace prohlížeče nesmí nikdy obejít vrstvu identity aplikace.
- Na serveru řešte identifikátory dokumentů – Přijímejte aplikační ID dokumentu, nikoli libovolnou fyzickou cestu souboru poskytnutou prohlížečem.
- Autorizujte každou operaci – Prohlížení, anotace, vyhledávání, stažení a tisk mohou vyžadovat různé oprávnění.
- Uchovávejte tajemství mimo zdrojový kód – Ukládejte licence, připojovací řetězce a šifrovací materiály v schváleném mechanismu správy tajemství.
- Aplikujte limity požadavků – Nastavte vhodné limity pro nahrávání, velikost dokumentu, časové limity a rychlostní limity kolem workflow prohlížeče.
- Zaznamenávejte bezpečnostní události – Logujte rozhodnutí o přístupu a akce s dokumenty, aniž byste zapisovali obsah dokumentů nebo citlivé tokeny do logů.
Považujte všechna nastavení SDK za verzovanou konfiguraci. Ověřte jejich význam v oficiální referenci, než je povolíte v produkci.
3️⃣ Krok 3 – Izolujte relace dokumentů za aplikační službou
Uchovávejte interakce specifické pro Doconut uvnitř dedikované aplikační služby. Odkazy na třídu Viewer jsou užitečné na úrovni architektury, ale signatury konstruktorů, metody pro otevírání dokumentů, požadavky na cache a chování při vyhledávání licence musí pocházet z dokumentace pro vaši nainstalovanou verzi.
Bezpečná hranice služby by měla:
- Přijmout autentizovaného uživatele a aplikační ID dokumentu.
- Ověřit oprávnění uživatele pro požadovanou akci.
- Načíst dokument ze schváleného úložiště na serveru.
- Požádat dokumentovanou API prohlížeče o vytvoření relace dokumentu.
- Vrátit pouze minimální neprůhledné informace o relaci potřebné klientovi.
- Uvolnit nebo vypršet relace podle vašich zásad retence a cache.
Prohlížeč by nikdy neměl získat fyzickou cestu úložiště, licenční data, interní klíč cache ani neomezený odkaz na originální dokument.
4️⃣ Krok 4 – Povolení anotací, vyhledávání a řízeného tisku
Anotace, vyhledávání, OCR a řízený tisk by měly být povoleny pouze tehdy, když jsou zahrnuty ve vaší licencované konfiguraci Doconut a jsou podporovány nainstalovanou verzí. Nepředpokládejte názvy metod, formáty perzistence ani třídy možností.
- Anotace – Rozhodněte, které role mohou vytvářet, upravovat, zobrazovat nebo mazat značky. Ukládejte stav anotací podle pokynů pro perzistenci ve vaší verzi SDK a vašich auditních požadavků.
- Vyhledávání a OCR – Stanovte, které typy dokumentů vyžadují OCR, kde se uchovává extrahovaný text a jak dlouho jsou indexy k dispozici. Považujte výsledky vyhledávání za data dokumentu a autorizujte je odpovídajícím způsobem.
- Řízený tisk – Definujte limity počtu stran, politiku vodoznaků, schvalovací pravidla a auditní události na úrovni aplikace, poté mapujte tyto požadavky na dokumentované možnosti tisku.
Uchovávejte tyto operace za stejnou aplikační službou, která slouží pro relace dokumentů, aby kontrolery zůstaly tenké a obchodní pravidla testovatelná.
5️⃣ Krok 5 – Připojte React front‑end
React aplikace by měla volat vaše autentizované API ASP.NET Core místo přijímání cest k úložišti nebo přímého připojení k interním službám dokumentů. Definujte vlastní API kontrakt orientovaný na zdroje kolem obchodních akcí a vyhněte se publikování názvů endpointů specifických pro SDK jako součást veřejného klientského kontraktu.
Typická sekvence interakcí je:
- Uživatel vybere dokument, který je již viditelný v aplikaci.
- React požádá o relaci prohlížení pomocí aplikačního ID dokumentu.
- ASP.NET Core autentizuje požadavek, autorizuje dokument a koordinuje relaci prohlížeče.
- React obdrží pouze informace potřebné k zobrazení prohlížeče.
- Požadavky na anotace, vyhledávání a tisk se vrací přes autentizované aplikační API.
- Server zaznamená auditní události a vyprší relaci, když je to vhodné.
V React UI udržujte stav relace krátkodobý, explicitně zpracovávejte selhání autorizace, vyhněte se ukládání citlivých hodnot do perzistentního úložiště prohlížeče a poskytujte načítací a chybové stavy, které neprozrazují interní cesty ani podrobnosti výjimek.
Toto oddělení ponechává vykreslování a kontrolu dokumentů na serveru, zatímco React zůstává zodpovědný za prezentaci a interakci.
Závěr
Umístěním integrace Doconut za bezpečnou aplikační službu ASP.NET Core můžete vybudovat portál pro PDF, Office, CAD a obrazové workflowy, aniž byste spojovali React rozhraní s nedokumentovanými detaily SDK. Autentizace, autorizace, životní cyklus relace, vyhledávání, anotace, tisk a auditní politika zůstávají explicitními částmi vašeho návrhu aplikace.
Připraven(a) vyzkoušet Doconut ve vašem .NET projektu? Použijte oficiální balíček, licencování a API dokumentaci pro vybranou verzi, poté aplikujte výše uvedený architektonický a bezpečnostní kontrolní seznam na vaši implementaci.