セッションとセキュリティ

ドキュメントセッションとアクセス制御

Doconut トークンは開かれたドキュメントを識別します。これを含むリクエストが処理されれば、取得した者はすべてのページを読むことができます。このページでは、ドキュメントセッションが保持するもの、存続期間、そして DocImage.axd が誰がページを見ることができるかを決定する仕組み(単一サーバーと ウェブファーム の両方)を説明します。

ドキュメントセッションが保持するもの

各成功した OpenDocumentAsync は 1 つのセッションを作成し、メモリに保持します:

  • ロードされたフォーマットビューア — パースされたドキュメントを保持するエンジンインスタンス、
  • ページ単位の状態 — 回転、フリップ、ウィジェットでユーザーが適用する注釈データ、
  • 任意の 検索インデックス、最初の検索時に構築され(または事前構築された .srh ファイルからロードされ)ます、
  • セッション 透かし は 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;
});

実用的な結果は 3 つあります:

  • オープンエンドポイントはセッション状態が必要です。 MVC コントローラとウェブフォームページはデフォルトで持っています。カスタム IHttpHandler は System.Web.SessionState.IRequiresSessionState を実装しない限り持ちません。セッションなしでオープンすると付与すべきものがなくなるため、ビューアはすべてのページで「このページの表示は許可されていません。」と表示します。
  • セッション状態はオンのままでなければなりません。 <sessionState mode="Off" /> を Web.config で無効にすると、付与とチェックの両方が無効になり、すべてのページが拒否されます。
  • ブラウザはセッションクッキーを送信しなければなりません。 ウィジェットのリクエストは同一オリジンであるため、ASP.NET_SessionId が自動的に付与されます。クッキー容器を持たないクライアント(スクリプト、サーバー間呼び出し、クッキーを除去するクロスオリジン設定)は拒否されます。これが機能していることです。

UnsafeMode = true はチェックをオフにします:トークンを含むすべてのリクエストが提供されます。これはドキュメントごとのオーバーライドがない、すべてのドキュメントに対するグローバルスイッチです。false のままにしてください。

取り消し

CloseDocument(token) はメモリ解放以上のことを行います:現在のリクエストのセッションから secure-{token} エントリを削除し、トークンを取り消すため、閉じられたトークンは即座に拒否されます。

ウェブファーム:署名済みチケット

ファームでは、次のリクエストがドキュメントを一度も見たことのないサーバーや別のワーカープロセス上のサーバーに届くことがあり、独自の ASP.NET セッションを持ちます。セッション付与はそれに追随できません。分散モードでは、ブラウザに結び付けられた 署名済みチケット に置き換えます:すべてのノードがドキュメントセッション用の単一ストアと署名キーを共有し、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 バイトで、すべてのノードで同じです
    }));

オープンエンドポイントは、開く前にチケットをブラウザに結び付け、トークンと共にチケットを返します:

  • DocOptions.BrowserId = DoconutFarmBinding.EnsureBrowserId(System.Web.HttpContext.Current, securityOptions) を設定します — それはチケットに結び付けられた doconut-client クッキーを発行し — そして DocOptions.UserId = DoconutFarmBinding.ResolveUserId(System.Web.HttpContext.Current);
  • OpenDocumentAsync 後、トークンと共に viewer.AccessToken を返します;
  • ページ内で、両方をウィジェットに渡します: objViewer.View(token, access)。

従来のウェブファームフラグ(IsWebfarm と ExportToPng)から移行しますか? 移行 がステップバイステップで変更を示します。

署名キーはソース管理に入れないでください:それはチケットに署名し、共有ストア内のドキュメントを暗号化します。異なるキーを持つノードは、他のノードが発行したすべてのチケットを拒否します。

実際のブラウザ、またはクッキーを保持するスクリプトでファームをテストしてください。doconut-client クッキーがないクライアントは 401 で応答されません:ステータス 200 の「認可されていない」エラー画像(約 2 KB)を受け取り、実際のページは数十から数百キロバイトです。

本番チェックリスト

  • UnsafeMode = false を保持してください(デフォルト)。
  • セッション状態を持つリクエストからドキュメントを開き、セッション状態をオフにしないでください。
  • セッションクッキーが DocImage.axd に届くことを確認してください(同一オリジン、HTTPS、それを許可する SameSite ポリシー)。
  • ウェブファームでは、すべてのノードが共有する 1 つの署名キーで分散モードを使用してください。
  • ユーザーがドキュメントを離れたときに CloseDocument を呼び出してください — メモリとセキュリティの両方が向上します。
  • トークンをログに記録したり共有したりしないでください;短命の認証情報として扱ってください。

このページは役に立ちましたか?