Relace a zabezpečení
Relace dokumentů a řízení přístupu
Token Doconut identifikuje otevřený dokument. Pokud by byl obsloužen jakýkoli požadavek, který jej nese, kdokoli, kdo jej získá, by mohl číst každou stránku. Tato stránka vysvětluje, co relace dokumentu obsahuje, jak dlouho žije a jak DocImage.axd rozhoduje, kdo může vidět její stránky — na jednom serveru i ve webové farmě.
Co relace dokumentu obsahuje
Každé úspěšné OpenDocumentAsync vytvoří jednu relaci, uchovávanou v paměti:
- načtený formátový prohlížeč — instance enginu, která drží parsovaný dokument,
- stav na stránce — rotace, převrácení a data anotací, která uživatel aplikuje ve widgetu,
- volitelný vyhledávací index, vytvořený při prvním vyhledávání (nebo načtený z předem vytvořeného souboru
.srh), - vodoznak relace z
DocOptions.Watermark.
Životnost
Relace vyprší po posuvném okně: DocOptions.TimeOut minut (výchozí 60), resetováno každým požadavkem, který token předloží. Když relace skončí — vypršením nebo CloseDocument(token) — je uvolněn engine dokumentu a jeho paměť okamžitě uvolněna.
// Krátkodobá relace pro jednorázový náhled
var token = await viewer.OpenDocumentAsync(path, new DocOptions { TimeOut = 10 });Požadavek s vypršeným tokenem získá chybový obrázek s textem Document session not found. Please re-open document.. Stránka musí znovu otevřít dokument, aby získala nový token. Na jediném serveru recyklace aplikačního poolu také ukončí každou relaci.
Stránky jsou podávány pouze relaci, která je otevřela
S UnsafeMode = false — výchozí — otevření dokumentu uděluje přístup k ASP.NET relaci požadavku, který jej otevřel, zápisem položky secure-{token} do této relace. DocImage.axd vyžaduje samotný stav relace a podává stránku jen tehdy, když požadovaná relace obsahuje tuto položku. Jakýkoli jiný prohlížeč, který předloží stejný token, získá chybový obrázek s textem You Are Not Authorized To View This Page.
Doconut.DoconutHost.Initialize(options =>
{
// false (výchozí): DocImage.axd poskytuje stránku pouze ASP.NET relaci, která ji otevřela
// dokument. Handler požaduje stav relace sám; potřebuje jen, aby site nebyl
// vypnout stav relace v Web.config.
options.UnsafeMode = false;
});Tři praktické důsledky:
- Otevřený koncový bod potřebuje stav relace. MVC kontrolery a Web Forms stránky jej mají ve výchozím nastavení. Vlastní
IHttpHandlerjej nemá, pokud neimplementujeSystem.Web.SessionState.IRequiresSessionState. Otevření, které běží bez relace, nemá co udělit, takže prohlížeč zobrazuje „Nejste oprávněni zobrazit tuto stránku.“ na každé stránce. - Stav relace musí zůstat zapnutý.
<sessionState mode="Off" />vWeb.configzakazuje jak udělení, tak kontrolu a každá stránka je odmítnuta. - Prohlížeč musí odesílat cookie relace. Požadavky widgetu jsou stejného původu, takže automaticky nesou
ASP.NET_SessionId. Klient bez úložiště cookies — skript, volání server‑to‑server, nastavení cross‑origin, které odstraňuje cookies — je odmítnut. To je funkce v akci.
UnsafeMode = true vypíná kontrolu: jakýkoli požadavek nesoucí token je obsloužen. Jedná se o jeden globální přepínač pro každý dokument, bez per‑dokumentového přepsání. Nechte ho false.
Odvolání
CloseDocument(token) dělá více než uvolnit paměť: odstraňuje položku secure-{token} z relace aktuálního požadavku a odvolává token, takže uzavřený token je okamžitě odmítnut.
Webové farmy: podepsané lístky
Ve farmě může další požadavek dopadnout na server, který dokument nikdy neviděl, v jiném pracovním procesu, se svou vlastní ASP.NET relací. Udělení relace jej nemůže následovat. Distribuovaný režim jej nahrazuje podepsaný lístek vázaný na prohlížeč: každý uzel sdílí jedno úložiště pro relace dokumentů a jeden podpisový klíč, a DocImage.axd přijímá požadavek, když je jeho lístek platný pro daný token, tento prohlížeč a — pokud je uživatel přihlášen — pro tohoto uživatele.
Nastavení, identické na každém uzlu:
// Global.asax.cs - Application_Start
// Tajný klíč farmy: alespoň 32 bajtů, stejný na každém uzlu, uchováván mimo správu verzí.
byte[] farmKey = Convert.FromBase64String(Environment.GetEnvironmentVariable("DOCONUT_FARM_KEY"));
Doconut.DoconutHost.Initialize(
options => options.UnsafeMode = false, // kontrola lístku běží pouze, když je to false
services => services.AddDoconutDistributed(d =>
{
d.Store = CloudLocation.FileShare;
d.FileShareRootPath = @"\\fileserver\doconut-shared"; // složka, ke které může přistupovat každý uzel
d.SigningKey = farmKey; // alespoň 32 bajtů, STEJNÝ na každém uzlu
}));Otevřený koncový bod pak před otevřením sváže lístek s prohlížečem a vrátí lístek spolu s tokenem:
- nastavte
DocOptions.BrowserId = DoconutFarmBinding.EnsureBrowserId(System.Web.HttpContext.Current, securityOptions)— vydá cookiedoconut-client, ke kterému je lístek vázán — aDocOptions.UserId = DoconutFarmBinding.ResolveUserId(System.Web.HttpContext.Current); - po
OpenDocumentAsyncvraťteviewer.AccessTokenspolu s tokenem; - na stránce předávejte oba widgetu:
objViewer.View(token, access).
Přechod od klasického příznaku web‑farmy (IsWebfarm s ExportToPng)? Migrace ukazuje změnu krok za krokem.
Uchovávejte podpisový klíč mimo správu zdrojového kódu: podepisuje lístky i šifruje dokumenty ve sdíleném úložišti. Uzel s jiným klíčem odmítá každý lístek, který vydaly ostatní.
Otestujte farmu skutečným prohlížečem nebo skriptem, který uchovává cookies. Klient bez cookie doconut-client nedostane odpověď 401: získá chybový obrázek „neautorizováno“ se stavem 200, asi 2 KB, zatímco skutečná stránka má desítky až stovky kilobytů.
Kontrolní seznam pro produkci
- Uchovejte
UnsafeMode = false(výchozí). - Otevírejte dokumenty z požadavků, které mají stav relace, a nikdy nevypínejte stav relace.
- Ujistěte se, že cookie relace dosáhne
DocImage.axd(stejný původ, HTTPS, politikaSameSite, která to umožňuje). - Ve farmě používejte distribuovaný režim s jedním podpisovým klíčem sdíleným všemi uzly.
- Zavolejte
CloseDocument, když uživatel opustí dokument — paměť i zabezpečení mají prospěch. - Nikdy neukládejte ani nesdílejte tokeny; považujte je za krátkodobé pověření.
Byla tato stránka užitečná?