Sessioni e Sicurezza
Sessioni di documento e controllo accessi
Un token Doconut identifica un documento aperto. Se qualsiasi richiesta che lo trasporta fosse servita, chi lo avesse ottenuto potrebbe leggere ogni pagina. Questa pagina spiega cosa contiene una sessione di documento, quanto dura e come DocImage.axd decide chi può vedere le sue pagine — su un singolo server e in un web farm.
Cosa contiene una sessione di documento
Ogni OpenDocumentAsync riuscito crea una sessione, mantenuta in memoria:
- il visualizzatore di formato caricato — l'istanza del motore che contiene il documento analizzato,
- stato per pagina — rotazione, capovolgimenti e i dati di annotazione che l'utente applica nel widget,
- l'indice di ricerca opzionale, costruito alla prima ricerca (o caricato da un file
.srhpre‑costruito), - il filigrana della sessione da
DocOptions.Watermark.
Durata
Le sessioni scadono su una finestra mobile: DocOptions.TimeOut minuti (predefinito 60), resettata da ogni richiesta che presenta il token. Quando una sessione termina — per scadenza o per CloseDocument(token) — il motore del documento viene rilasciato e la sua memoria liberata immediatamente.
// Una sessione di breve durata per un'anteprima istantanea
var token = await viewer.OpenDocumentAsync(path, new DocOptions { TimeOut = 10 });Una richiesta con un token scaduto ottiene un'immagine di errore che mostra Document session not found. Please re-open document.. La pagina deve aprire nuovamente il documento per ottenere un nuovo token. Su un singolo server, il riciclo del pool dell'applicazione termina anche tutte le sessioni.
Le pagine sono servite solo alla sessione che le ha aperte
Con UnsafeMode = false — il valore predefinito — aprire un documento concede l'accesso alla sessione ASP.NET della richiesta che lo ha aperto, scrivendo una voce secure-{token} in quella sessione. DocImage.axd richiede lo stato di sessione stesso e serve una pagina solo quando la sessione richiedente contiene quella voce. Qualsiasi altro browser che presenta lo stesso token ottiene un'immagine di errore che mostra You Are Not Authorized To View This Page.
Doconut.DoconutHost.Initialize(options =>
{
// false (il valore predefinito): DocImage.axd serve una pagina solo alla sessione ASP.NET che l'ha aperta
// il documento. Il gestore richiede lo stato della sessione da solo; ha solo bisogno che il sito non
// disattivare lo stato della sessione in Web.config.
options.UnsafeMode = false;
});Tre conseguenze pratiche:
- L'endpoint di apertura richiede lo stato di sessione. I controller MVC e le pagine Web Forms lo hanno per impostazione predefinita. Un
IHttpHandlerpersonalizzato non lo ha a meno che non implementiSystem.Web.SessionState.IRequiresSessionState. Un'apertura che gira senza sessione non ha nulla da concedere, quindi il visualizzatore mostra "Non sei autorizzato a visualizzare questa pagina." su ogni pagina. - Lo stato di sessione deve rimanere attivo.
<sessionState mode="Off" />inWeb.configdisabilita sia la concessione sia il controllo, e ogni pagina viene rifiutata. - Il browser deve inviare il cookie di sessione. Le richieste del widget sono della stessa origine, quindi trasportano
ASP.NET_SessionIdautomaticamente. Un client senza un contenitore di cookie — uno script, una chiamata server‑to‑server, una configurazione cross‑origin che rimuove i cookie — viene rifiutato. Questa è la funzionalità in azione.
UnsafeMode = true disattiva il controllo: qualsiasi richiesta che trasporta il token viene servita. È un interruttore globale per ogni documento, senza sovrascrittura per documento. Lascialo false.
Revoca
CloseDocument(token) fa più che liberare memoria: rimuove la voce secure-{token} dalla sessione della richiesta corrente e revoca il token, così un token chiuso viene rifiutato immediatamente.
Web farm: ticket firmati
In un farm, la richiesta successiva può arrivare su un server che non ha mai visto il documento, in un processo worker diverso, con la propria sessione ASP.NET. La concessione di sessione non può seguirla. La modalità distribuita la sostituisce con un ticket firmato legato al browser: ogni nodo condivide un unico archivio per le sessioni dei documenti e una chiave di firma, e DocImage.axd accetta una richiesta quando il suo ticket è valido per quel token, quel browser e — quando l'utente è autenticato — quell'utente.
La configurazione, identica su ogni nodo:
// Global.asax.cs - Application_Start
// Il segreto del farm: almeno 32 byte, lo stesso su ogni nodo, tenuto fuori dal controllo di versione.
byte[] farmKey = Convert.FromBase64String(Environment.GetEnvironmentVariable("DOCONUT_FARM_KEY"));
Doconut.DoconutHost.Initialize(
options => options.UnsafeMode = false, // il controllo del ticket viene eseguito solo quando questo è false
services => services.AddDoconutDistributed(d =>
{
d.Store = CloudLocation.FileShare;
d.FileShareRootPath = @"\\fileserver\doconut-shared"; // una cartella raggiungibile da ogni nodo
d.SigningKey = farmKey; // almeno 32 byte, lo STESSO su ogni nodo
}));L'endpoint di apertura quindi associa il ticket al browser prima di aprire, e restituisce il ticket insieme al token:
- imposta
DocOptions.BrowserId = DoconutFarmBinding.EnsureBrowserId(System.Web.HttpContext.Current, securityOptions)— emette il cookiedoconut-clienta cui il ticket è legato — eDocOptions.UserId = DoconutFarmBinding.ResolveUserId(System.Web.HttpContext.Current); - dopo
OpenDocumentAsync, restituisciviewer.AccessTokeninsieme al token; - nella pagina, passa entrambi al widget:
objViewer.View(token, access).
Stai passando dalla bandiera classica del web‑farm (IsWebfarm con ExportToPng)? Migrazione mostra il cambiamento passo dopo passo.
Mantieni la chiave di firma fuori dal controllo del codice sorgente: firma sia i ticket sia cripta i documenti nello store condiviso. Un nodo con una chiave diversa rifiuta ogni ticket emesso dagli altri.
Testa un farm con un browser reale, o con uno script che conserva i cookie. Un client senza il cookie doconut-client non riceve 401: ottiene l'immagine di errore "non autorizzato" con stato 200, circa 2 KB, dove una pagina reale è di decine o centinaia di kilobyte.
Checklist di produzione
- Mantieni
UnsafeMode = false(il valore predefinito). - Apri i documenti da richieste che hanno lo stato di sessione, e non disattivare mai lo stato di sessione.
- Assicurati che il cookie di sessione raggiunga
DocImage.axd(stessa origine, HTTPS, una politicaSameSiteche lo consenta). - In un farm, usa la modalità distribuita con una chiave di firma condivisa da tutti i nodi.
- Chiama
CloseDocumentquando l'utente abbandona un documento — la memoria e la sicurezza ne traggono beneficio. - Non registrare né condividere i token; trattali come credenziali a breve durata.
Questa pagina è stata utile?