Сесії та безпека
Сесії документів та контроль доступу
Токен Doconut ідентифікує відкритий документ. Якщо будь‑який запит, що містить його, буде обслуговуватись, той, хто його отримав, зможе прочитати кожну сторінку. Ця сторінка пояснює, що містить сесія документу, скільки вона живе і як DocImage.axd вирішує, хто може бачити її сторінки — на одному сервері та у веб‑фермі.
Що містить сесія документу
Кожен успішний OpenDocumentAsync створює одну сесію, що зберігається в пам'яті:
- завантажений переглядач формату — екземпляр рушія, що тримає розпарсений документ,
- стан на сторінці — обертання, перевертання та дані анотацій, які користувач застосовує у віджеті,
- необов'язковий індекс пошуку, створений під час першого пошуку (або завантажений з попередньо створеного файлу
.srh), - водяний знак сесії з
DocOptions.Watermark.
Термін життя
Сесії закінчуються через ковзне вікно: DocOptions.TimeOut хвилин (за замовчуванням 60), скидається кожним запитом, що представляє токен. Коли сесія завершується — через закінчення терміну або через CloseDocument(token) — її рушій документа звільняється, і пам'ять звільняється негайно.
// Короткоживуча сесія для одноразового попереднього перегляду
var token = await viewer.OpenDocumentAsync(path, new DocOptions { TimeOut = 10 });Запит з простроченим токеном отримує зображення помилки з текстом Document session not found. Please re-open document.. Сторінка повинна знову відкрити документ, щоб отримати новий токен. На одному сервері перезапуск пулу застосунків завершує також усі сесії.
Сторінки подаються лише сесії, яка їх відкрила
За допомогою UnsafeMode = false — за замовчуванням — відкриття документа надає доступ до ASP.NET‑сесії запиту, який його відкрив, шляхом запису запису secure-{token} у цю сесію. DocImage.axd вимагає сам стан сесії і подає сторінку лише коли запитуюча сесія містить цей запис. Будь‑який інший браузер, що представляє той самий токен, отримує зображення помилки з текстом You Are Not Authorized To View This Page..
Doconut.DoconutHost.Initialize(options =>
{
// false (за замовчуванням): DocImage.axd обслуговує сторінку лише для ASP.NET сесії, яка її відкрила
// документ. Обробник сам запитує стан сесії; йому потрібно лише, щоб сайт не
// вимикав стан сесії у Web.config.
options.UnsafeMode = false;
});Три практичні наслідки:
- Точка відкриття потребує стану сесії. MVC‑контролери та сторінки Web Forms мають його за замовчуванням. Користувацький
IHttpHandlerне має його, якщо не реалізуєSystem.Web.SessionState.IRequiresSessionState. Відкриття, що працює без сесії, не має чого надавати, тому переглядач показує «Ви не маєте дозволу переглядати цю сторінку.» на кожній сторінці. - Стан сесії має залишатися ввімкненим.
<sessionState mode="Off" />уWeb.configвимикає як надання, так і перевірку, і кожна сторінка відхиляється. - Браузер має надсилати cookie сесії. Запити віджету з однаковим походженням автоматично передають
ASP.NET_SessionId. Клієнт без cookie‑банки — скрипт, виклик сервер‑до‑сервера, крос‑origin налаштування, що видаляє cookie — відхиляється. Це працююча функція.
UnsafeMode = true вимикає перевірку: будь‑який запит, що містить токен, обслуговується. Це один глобальний перемикач для кожного документа, без індивідуального перевизначення. Залиште його false.
Відкликання
CloseDocument(token) робить більше, ніж звільняє пам'ять: він видаляє запис secure-{token} з сесії поточного запиту і відкликає токен, тому закритий токен відразу відхиляється.
Веб‑ферми: підписані квитки
У фермі наступний запит може потрапити на сервер, який ніколи не бачив документ, у іншому робочому процесі, зі своєю ASP.NET‑сесією. Надання сесії не може його слідувати. Розподілений режим замінює його на підписаний квиток, прив’язаний до браузера: кожен вузол спільно використовує одне сховище сесій документів і один ключ підпису, і DocImage.axd приймає запит, коли його квиток дійсний для цього токену, цього браузера і — коли користувач увійшов — цього користувача.
Налаштування, однакове на кожному вузлі:
// Global.asax.cs - Application_Start
// Секрет ферми: принаймні 32 байти, однаковий на кожному вузлі, зберігається поза системою контролю версій.
byte[] farmKey = Convert.FromBase64String(Environment.GetEnvironmentVariable("DOCONUT_FARM_KEY"));
Doconut.DoconutHost.Initialize(
options => options.UnsafeMode = false, // перевірка квитка виконується лише коли це false
services => services.AddDoconutDistributed(d =>
{
d.Store = CloudLocation.FileShare;
d.FileShareRootPath = @"\\fileserver\doconut-shared"; // тека, до якої може дістатися кожен вузол
d.SigningKey = farmKey; // принаймні 32 байти, однакові на кожному вузлі
}));Точка відкриття потім прив’язує квиток до браузера перед відкриттям і повертає квиток разом з токеном:
- встановити
DocOptions.BrowserId = DoconutFarmBinding.EnsureBrowserId(System.Web.HttpContext.Current, securityOptions)— він видає cookiedoconut-client, до якого прив’язаний квиток — іDocOptions.UserId = DoconutFarmBinding.ResolveUserId(System.Web.HttpContext.Current); - після
OpenDocumentAsync, повернутиviewer.AccessTokenразом з токеном; - на сторінці передати обидва у віджет:
objViewer.View(token, access).
Перехід від класичного прапорця веб‑ферми (IsWebfarm з ExportToPng)? Міграція показує зміни крок за кроком.
Тримайте ключ підпису поза системою контролю версій: він підписує квитки і шифрує документи у спільному сховищі. Вузол з іншим ключем відхиляє кожен квиток, виданий іншими.
Протестуйте ферму реальним браузером або скриптом, який зберігає cookie. Клієнт без cookie doconut-client не отримує відповіді з 401: він отримує зображення помилки «не авторизовано» зі статусом 200, приблизно 2 КБ, тоді як реальна сторінка важить десятки‑сотні кілобайт.
Контрольний список для продакшн
- Залиште
UnsafeMode = false(за замовчуванням). - Відкривайте документи лише з запитів, які мають стан сесії, і ніколи не вимикайте стан сесії.
- Переконайтеся, що cookie сесії досягає
DocImage.axd(з однаковим походженням, HTTPS, політикаSameSite, яка це дозволяє). - У фермі використовуйте розподілений режим з одним ключем підпису, спільним для всіх вузлів.
- Викликайте
CloseDocument, коли користувач залишає документ — це корисно і для пам'яті, і для безпеки. - Ніколи не реєструйте і не діліться токенами; розглядайте їх як короткоживучі облікові дані.
Чи була ця сторінка корисною?