セッションとセキュリティ
ドキュメントセッションとアクセス制御
Doconut トークンは開かれたドキュメントを識別します。これを含むリクエストが処理されれば、取得した者はすべてのページを読むことができます。このページでは、ドキュメントセッションが保持するもの、存続期間、そして DocImage.axd が誰がページを見ることができるかを決定する仕組み(単一サーバーと ウェブファーム の両方)を説明します。
ドキュメントセッションが保持するもの
各成功した OpenDocumentAsync は 1 つのセッションを作成し、メモリに保持します:
- ロードされたフォーマットビューア — パースされたドキュメントを保持するエンジンインスタンス、
- ページ単位の状態 — 回転、フリップ、ウィジェットでユーザーが適用する注釈データ、
- 任意の 検索インデックス、最初の検索時に構築され(または事前構築された
.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;
});実用的な結果は 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 はそのチケットがトークン、ブラウザ、そしてユーザーがサインインしている場合はそのユーザーに対して有効なときにリクエストを受け入れます。
設定はすべてのノードで同一です:
// 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を呼び出してください — メモリとセキュリティの両方が向上します。 - トークンをログに記録したり共有したりしないでください;短命の認証情報として扱ってください。
このページは役に立ちましたか?