Сеансы и безопасность

Сеансы документов и контроль доступа

Токен Doconut идентифицирует открытый документ. Если любой запрос, содержащий его, будет обслужен, тот, кто его получил, сможет прочитать каждую страницу. Эта страница объясняет, что хранит сеанс документа, как долго он живёт и как DocImage.axd решает, кто может видеть его страницы — на одном сервере и в веб‑ферме.

Что хранит сеанс документа

Каждый успешный OpenDocumentAsync создаёт один сеанс, хранящийся в памяти:

  • loaded format viewer — экземпляр движка, содержащий разобранный документ,
  • per-page state — вращение, отражения и данные аннотаций, которые пользователь применяет в виджете,
  • опциональный search index, построенный при первом поиске (или загруженный из предварительно созданного файла .srh),
  • сеансовый watermark из DocOptions.Watermark.

Время жизни

Сеансы истекают по скользящему окну: DocOptions.TimeOut минут (по умолчанию 60), сбрасывается каждым запросом, представляющим токен. Когда сеанс заканчивается — по истечении срока или из‑за CloseDocument(token) — его движок документа освобождается, и память освобождается немедленно.

csharp
// Краткосрочная сессия для одноразового предварительного просмотра
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..

csharp
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‑хранилища — скрипт, вызов сервер‑к‑серверу, кросс‑доменные настройки, которые удаляют cookies — отклоняется. Это и есть работающая функция.

UnsafeMode = true отключает проверку: любой запрос, содержащий токен, обслуживается. Это один глобальный переключатель для каждого документа, без переопределения на уровне документа. Оставьте его false.

Отзыв

CloseDocument(token) делает больше, чем освобождает память: он удаляет запись secure-{token} из сеанса текущего запроса и отзывает токен, поэтому закрытый токен сразу отклоняется.

Веб‑фермы: подписанные билеты

В ферме следующий запрос может попасть на сервер, который никогда не видел документ, в другом рабочем процессе, со своим собственным ASP.NET‑сеансом. Предоставление сеанса не может его последовать. Распределённый режим заменяет его на signed ticket, привязанный к браузеру: каждый узел использует общее хранилище сеансов документов и один ключ подписи, и DocImage.axd принимает запрос, когда его билет действителен для данного токена, данного браузера и — когда пользователь вошёл в систему — данного пользователя.

Настройка, одинаковая на каждом узле:

csharp
// 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 байт, SAME на каждом узле
    }));

Точка открытия затем привязывает билет к браузеру перед открытием и возвращает билет вместе с токеном:

  • установить DocOptions.BrowserId = DoconutFarmBinding.EnsureBrowserId(System.Web.HttpContext.Current, securityOptions) — он выдаёт cookie doconut-client, к которому привязан билет — и DocOptions.UserId = DoconutFarmBinding.ResolveUserId(System.Web.HttpContext.Current);
  • после OpenDocumentAsync вернуть viewer.AccessToken вместе с токеном;
  • в странице передать оба в виджет: objViewer.View(token, access).

Переход от классического флага веб‑фермы (IsWebfarm с ExportToPng)? Миграция показывает изменение шаг за шагом.

Держите ключ подписи вне системы контроля версий: он одновременно подписывает билеты и шифрует документы в общем хранилище. Узел с другим ключом отклоняет каждый билет, выданный другими.

Протестируйте ферму реальным браузером или скриптом, сохраняющим cookies. Клиент без cookie doconut-client не получает ответ с 401: он получает изображение ошибки «не авторизован» со статусом 200, около 2 KB, тогда как реальная страница весит от десятков до сотен килобайт.

Список проверок для продакшн

  • Оставьте UnsafeMode = false (по умолчанию).
  • Открывайте документы из запросов, имеющих состояние сеанса, и никогда не отключайте состояние сеанса.
  • Убедитесь, что cookie сеанса достигает DocImage.axd (одноисточник, HTTPS, политика SameSite, позволяющая это).
  • В ферме используйте распределённый режим с одним ключом подписи, общим для всех узлов.
  • Вызывайте CloseDocument, когда пользователь покидает документ — это выгодно для памяти и безопасности.
  • Никогда не журналируйте и не делитесь токенами; рассматривайте их как краткоживущие учётные данные.

Была ли эта страница полезной?