Sessioner & Säkerhet

Dokumentsessioner och åtkomstkontroll

En Doconut-token identifierar ett öppet dokument. Om någon begäran som bär den serveras, kan den som erhåller den läsa varje sida. Den här sidan förklarar vad en dokumentsession innehåller, hur länge den lever, och hur DocImage.axd bestämmer vem som får se dess sidor — på en server och i en webbfarm.

Vad en dokumentsession innehåller

Varje lyckad OpenDocumentAsync skapar en session, som hålls i minnet:

  • den laddade formatvisaren — motorinstansen som håller det parsade dokumentet,
  • per-sidostatus — rotation, vändningar och annoteringsdata som användaren applicerar i widgeten,
  • det valfria sökindexet, byggt vid den första sökningen (eller laddat från en förbyggd .srh-fil),
  • sessionens vattenstämpel från DocOptions.Watermark.

Livstid

Sessioner löper ut på ett glidande fönster: DocOptions.TimeOut minuter (standard 60), återställs av varje begäran som presenterar token. När en session avslutas — genom utgång eller genom CloseDocument(token) — frigörs dess dokumentmotor och dess minne frigörs omedelbart.

csharp
// En kortlivad session för en engångsförhandsgranskning
var token = await viewer.OpenDocumentAsync(path, new DocOptions { TimeOut = 10 });

En begäran med en utgången token får en felbild med texten Document session not found. Please re-open document.. Sidan måste öppna dokumentet igen för att få en ny token. På en enskild server avslutar återvinning av applikationspoolen också varje session.

Sidor serveras endast till den session som öppnade dem

Med UnsafeMode = false — standardvärdet — ger öppning av ett dokument åtkomst till ASP.NET-sessionen för den begäran som öppnade det, genom att skriva en secure-{token}-post i den sessionen. DocImage.axd kräver själva sessionsstatusen, och serverar en sida endast när den begärande sessionen har den posten. Alla andra webbläsare som presenterar samma token får en felbild med texten You Are Not Authorized To View This Page.

csharp
Doconut.DoconutHost.Initialize(options =>
{
    // false (standardvärdet): DocImage.axd levererar en sida endast till den ASP.NET-session som öppnade
    // dokumentet. Handlaren begär sessionsstatus själv; den behöver bara att webbplatsen inte
    // stänger av sessionsstatus i Web.config.
    options.UnsafeMode = false;
});

Tre praktiska konsekvenser:

  • Öppningsändpunkten behöver sessionsstatus. MVC‑kontrollers och Web Forms‑sidor har den som standard. En anpassad IHttpHandler har den inte om den inte implementerar System.Web.SessionState.IRequiresSessionState. En öppning som körs utan en session har inget att bevilja, så visaren visar "You Are Not Authorized To View This Page." på varje sida.
  • Sessionsstatus måste vara på. <sessionState mode="Off" /> i Web.config inaktiverar både beviljandet och kontrollen, och varje sida avvisas.
  • Webbläsaren måste skicka sessionskakan. Widgetens begäranden är samma ursprung, så de bär ASP.NET_SessionId automatiskt. En klient utan en cookie‑behållare — ett skript, ett server‑till‑server‑anrop, en cross‑origin‑konfiguration som tar bort cookies — avvisas. Det är funktionen som fungerar.

UnsafeMode = true stänger av kontrollen: varje begäran som bär token serveras. Det är en global växel för varje dokument, utan per‑dokument‑överskrivning. Lämna den false.

Återkallelse

CloseDocument(token) gör mer än att frigöra minne: den tar bort secure-{token}-posten från den aktuella begärans session och återkallar token, så en stängd token avvisas omedelbart.

Webbfarmer: signerade biljetter

I en farm kan nästa begäran hamna på en server som aldrig har sett dokumentet, i en annan arbetsprocess, med sin egen ASP.NET-session. Sessionsbeviljandet kan inte följa den. Distribuerat läge ersätter det med en signerad biljett bunden till webbläsaren: varje nod delar en lagring för dokumentsessioner och en signeringsnyckel, och DocImage.axd accepterar en begäran när dess biljett är giltig för den token, den webbläsaren, och — när användaren är inloggad — den användaren.

Konfigurationen, identisk på varje nod:

csharp
// Global.asax.cs - Application_Start
// Farmshemligheten: minst 32 byte, samma på varje nod, hålls utanför källkontrollen.
byte[] farmKey = Convert.FromBase64String(Environment.GetEnvironmentVariable("DOCONUT_FARM_KEY"));

Doconut.DoconutHost.Initialize(
    options => options.UnsafeMode = false,     // biljettkontrollen körs bara när detta är false
    services => services.AddDoconutDistributed(d =>
    {
        d.Store             = CloudLocation.FileShare;
        d.FileShareRootPath = @"\\fileserver\doconut-shared";  // en mapp som varje nod kan nå
        d.SigningKey        = farmKey;                          // minst 32 byte, SAMMA på varje nod
    }));

Öppningsändpunkten binder sedan biljetten till webbläsaren innan den öppnas, och returnerar biljetten med token:

  • sätt DocOptions.BrowserId = DoconutFarmBinding.EnsureBrowserId(System.Web.HttpContext.Current, securityOptions) — den utfärdar doconut-client-kakan som biljetten är knuten till — och DocOptions.UserId = DoconutFarmBinding.ResolveUserId(System.Web.HttpContext.Current);
  • efter OpenDocumentAsync, returnera viewer.AccessToken tillsammans med token;
  • i sidan, skicka båda till widgeten: objViewer.View(token, access).

Byta från den klassiska webbfarmflaggan (IsWebfarm med ExportToPng)? Migration visar förändringen steg för steg.

Håll signeringsnyckeln utanför källkodshantering: den både signerar biljetterna och krypterar dokumenten i den delade lagringen. En nod med en annan nyckel avvisar varje biljett som de andra utfärdat.

Testa en farm med en riktig webbläsare, eller ett skript som behåller cookies. En klient utan doconut-client-kakan svaras inte med 401: den får felbilden "not authorized" med status 200, cirka 2 KB, där en riktig sida är tiotals till hundratals kilobyte.

Produktionschecklista

  • Behåll UnsafeMode = false (standard).
  • Öppna dokument från begäranden som har sessionsstatus, och stäng aldrig av sessionsstatus.
  • Se till att sessionskakan når DocImage.axd (samma ursprung, HTTPS, en SameSite-policy som tillåter det).
  • I en farm, använd distribuerat läge med en signeringsnyckel som delas av varje nod.
  • Anropa CloseDocument när användaren lämnar ett dokument — minne och säkerhet drar nytta av det.
  • Logga eller dela aldrig tokens; behandla dem som kortlivade autentiseringsuppgifter.

Var den här sidan hjälpsam?