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.

csharp
// 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.

csharp
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í IHttpHandler jej nemá, pokud neimplementuje System.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" /> v Web.config zakazuje 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:

csharp
// 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á cookie doconut-client, ke kterému je lístek vázán — a DocOptions.UserId = DoconutFarmBinding.ResolveUserId(System.Web.HttpContext.Current);
  • po OpenDocumentAsync vraťte viewer.AccessToken spolu 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, politika SameSite, 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á?