Návod: Řízení přístupu k tisku s Doconut
21. 8. 2026

Návod: Řízení přístupu k tisku s Doconut

Plánujte přístup k tisku Doconut pomocí oficiálních produktových zdrojů, oprávnění vlastněných aplikací, chráněných operací, přehledného UX a praktických testů.

The official katalog funkcí Doconut lists browser printing and PDF export as viewer capabilities. Controlling access to them still requires two separate decisions: whether Doconut presents the relevant action and whether the host application authorizes that operation for the current user and document.

Cesta tisku dokumentu končící u řízené autorizační brány
Cesta tisku dokumentu končící u řízené autorizační brány

For the exact controls supported by your installed build, start with the dokumentace Doconut and the packaged samples available from the official stahovací stránka Doconut. Do not copy configuration keys or source code from an unrelated version or an unverified article.


1. Nejprve definujte tiskovou politiku

Zapište, kdo může tisknout a za jakých podmínek, ještě před změnou panelu nástrojů. Užitečná politika odpovídá na otázky jako:

  • Je tisk povolen pro každého prohlížeče, jen pro určité role nebo konkrétní dokumenty?
  • Závisí rozhodnutí na nájemci, stavu případu, klasifikaci dokumentu nebo expiraci?
  • Je vyžadována vodoznak na tisknutém výstupu?
  • Měly by být tiskové události auditovány?
  • Může uživatel vytisknout starší revizi dokumentu?
  • Co se má stát, když se oprávnění změní, zatímco je náhled otevřený?

Vyhněte se jedinému globálnímu typu Boolean, když je skutečné pravidlo kontextové. Modelujte tisk jako samostatnou operaci, aby mohl být autorizován nezávisle na prohlížení a stahování.

2. Oddělte stav UI od autorizace

Hostitelská stránka může rozhodnout, zda zobrazí tiskové ovládání poté, co obdrží výsledek oprávnění vlastněného aplikací. To zlepšuje přehlednost pro uživatele, kteří nemohou tisknout.

Nicméně skrytí ovládacího prvku není autorizační hranice. Uživatel může stále přímo zavolat známý endpoint, zopakovat předchozí požadavek nebo spustit tisk v prohlížeči na viditelném obsahu. Každá serverová cesta, která generuje tisknutelný výstup, musí vynucovat stejnou politiku.

Použijte odlišné stavy v UI:

StavChování prohlížečeChování serveru
Tisk povolenZobrazit podporovanou tiskovou akciAutorizovat a vytvořit požadovaný výstup
Tisk zakázánSkrýt nebo zakázat akci s jasným vysvětlenímVrátit odpověď s kódem zakázáno
Politika neznámáUdržet akci nedostupnou, dokud se načítají oprávněníNevytvářet výstup
Relace vypršelaPožádat uživatele o opětovné přihlášeníOdmítnout zastaralý požadavek

3. Chraňte tiskový endpoint

Chraňte aplikační operaci, která spouští tisk nebo vrací tisknutelný výstup. Rozhodnutí o autorizaci by mělo zohlednit členství v nájemci, vlastnictví, klasifikaci, stav pracovního postupu a revizi dokumentu. Dokument vyřešte na serveru místo přijímání cesty nebo URL úložiště dodané klientem.

Pokud vaše aplikace tiskne přes specifickou cestu prohlížeče místo vytváření PDF, použijte stejnou autorizaci před voláním této cesty.

4. Nakonfigurujte nainstalovanou verzi prohlížeče

Jakmile existuje pravidlo na serveru, nakonfigurujte UI Doconut pomocí přesné volby zdokumentované pro balíček a ukázkové soubory dodávané s vaší verzí. Živé ukázky Doconut vám umožní pozorovat podporované chování prohlížeče, než se zavážete k určité integraci. Ověřte:

  1. Kde je volba nastavena: konfigurace serveru, view model nebo inicializace klienta.
  2. Zda skrývá položku panelu nástrojů, zakazuje akci nebo ovlivňuje generovaný výstup.
  3. Zda se hodnota vztahuje na jednotlivou instanci prohlížeče nebo globálně.
  4. Zda jsou tisk a export samostatné operace.
  5. Zda aktualizace změnila název volby nebo výchozí hodnotu.

Považujte oficiální ukázku za pravdivý zdroj. Pouze pravděpodobně vypadající název vlastnosti není dostatečným důkazem, že nainstalovaný prohlížeč jej rozpozná.

5. Řádně zacházejte s tiskem v prohlížeči

Nastavení prohlížeče nemůže zaručit, že viditelné informace nebudou nikdy vytištěny nebo zachyceny. Prohlížeč může vytisknout hostitelskou stránku a uživatelé mohou pořizovat snímky obrazovky nebo fotografie. Zachycení klávesnice a CSS specifické pro tisk mohou zlepšit očekávaný zážitek, ale jsou obcházetelné klientské opatření.

Pokud hostitelská stránka nemá vytvářet užitečnou papírovou kopii, může vaše aplikace použít vlastní tiskově specifickou prezentaci a nahradit náhled vysvětlující zprávou. Udržujte toto chování hostitelské stránky oddělené od dokumentovaných ovládacích prvků prohlížeče Doconut.

Neoznačujte to jako ochranu dokumentu. Používejte serverové vykreslování, autorizaci, řízené exporty a viditelné vodoznaky, pokud vaše hodnocení rizik vyžaduje silnější odstrašování.

6. Udržujte stahování, export a tisk oddělené

  • Zobrazení zobrazuje vykreslený obsah.
  • Stáhnout vrací zdroj nebo jiný uložený soubor.
  • Export vytváří odvozený formát.
  • Tisk vytváří tisknutelnou reprezentaci nebo spouští tisk v prohlížeči.

Autorizujte každou operaci explicitně. Uživatel, který nemůže tisknout, může mít stále povoleno stahování, nebo naopak. Vaše panel nástrojů by měl odrážet rozhodnutí serveru, nikoli je definovat.

7. Přidejte užitečné auditní události

Pokud je tisk citlivý, zaznamenejte rozhodnutí bez logování samotného dokumentu. Událost může obsahovat uživatele, nájemce, identifikátor dokumentu, revizi, výsledek politiky, časové razítko a korelační ID.

Zaznamenávejte jak úspěšné, tak odmítnuté pokusy. Pokud tisková služba vytvoří dočasný soubor, zaznamenejte také, zda bylo jeho vyčištění dokončeno. Udržujte cesty k souborům, tokeny, názvy dokumentů obsahující osobní údaje a tisknutelný obsah mimo běžné logy.

8. Testujte i mimo chybějící tlačítko

Panel nástrojů je jen první tvrzení. Přidejte testy pro celou operaci:

Autorizovaný uživatel

  • Požadovaná tisková akce je viditelná.
  • Tisková žádost uspěje pro povolený dokument.
  • Je použita správná revize.
  • Požadované označení se objeví na vygenerovaném výstupu.
  • Auditní událost zaznamená úspěch.

Neautorizovaný uživatel

  • Akce chybí nebo je zakázána.
  • Přímá žádost na tiskovou cestu vrátí odpověď zakázáno.
  • Změna ID dokumentu neobchází pravidlo.
  • URL zkopírovaná z autorizované relace nelze zneužít.
  • Odmítnutí neprozrazuje, zda dokument vlastní jiný nájemce.

Změny stavu

  • Oprávnění odebrané během relace je vynuceno při další tiskové žádosti.
  • Vypršená relace nemůže tisknout.
  • Smazaný nebo nahrazený dokument vyvolá řízenou chybu.
  • Dočasný tiskový výstup se řídí nastaveným pravidlem uchovávání.

Automatizace prohlížeče může ověřit viditelný stav a kód odpovědi. Integrační testy by měly nezávisle ověřovat vyhodnocení politiky a autorizaci na úrovni dokumentu.

Časté otázky

Zabrání skrytí tlačítka tisku zkratce tisku v prohlížeči?
Ne. Odstraní to zamýšlenou akci prohlížeče pouze v případě, že nainstalovaný prohlížeč tuto funkci implementuje. Tisk v prohlížeči a zachycení obrazovky vyžadují samostatné zohlednění a nelze je zcela zabránit pomocí kódu na straně klienta.

Měla by být oprávnění k tisku zahrnuta do URL prohlížení?
Upřednostněte rozhodnutí o autorizaci na straně serveru, které je svázáno s ověřeným uživatelem, dokumentem a operací. Pokud dočasná reference nese oprávnění, omezte ji úzce, chraňte ji před logy a referrery a znovu ověřujte citlivé akce.

Je vypnutí tisku dostačující pro důvěrné dokumenty?
Ne. Je to jen jedno z opatření použitelnosti nebo odstrašování. Důvěrné pracovní postupy také vyžadují ochranu úložiště, autorizaci na úrovni objektu, řízené exporty, pravidla uchovávání, monitorování a přijatelný model reziduálního rizika.

Závěr

Spolehlivá implementace řízení tisku v Doconut začíná na serveru a končí v rozhraní. Definujte politiku, chraňte operaci, nakonfigurujte pouze dokumentovanou možnost pro váš nainstalovaný prohlížeč, vysvětlete výsledek uživatelům a testujte přímé požadavky i viditelnost panelu nástrojů. Používejte oficiální stránku funkce, dokumentaci, ke stažení a demoverze jako zdroje implementace místo přepisování kódu produktu v článku.