セッションとセキュリティ
ドキュメントセッションとアクセス制御
Doconut トークンは強力です:それを提示した者は、オープニングセッションにバインドされていなければ、ドキュメントのすべてのページを要求できてしまいます。このページでは、セッションが何を保持し、どのくらいの期間存続し、デフォルトで UseDoconut() が有効にするチェックについて説明します。
ドキュメントセッションが保持するもの
各成功した OpenDocumentAsync は、IMemoryCache に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(デフォルト)を使用すると、OpenDocumentAsync は新しいトークンをそれを開いた HTTP リクエストの ASP.NET セッション にバインドし、secure-{token} マーカーを書き込みます。Doconut ミドルウェアは、他のブラウザセッションへのページ提供を拒否します:
- 盗まれたトークンを提示する別のブラウザ/セッション → エラー画像
You Are Not Authorized To View This Page. - セッションミドルウェアが登録されていない → HTTP 500
Session middleware not configured. Call UseSession() before UseDoconut().
これが、Quick Start が Doconut ブランチの前に AddSession() + app.UseSession() を必須とする理由です。実務上の2つの結果:
- クライアントはページリクエストに ASP.NET セッション クッキー を送信しなければなりません。クッキーを除去するクロスオリジン設定(またはクッキージャーを持たない API クライアント)はチェックに失敗します — これはバグではなく機能が働いていることです。
options.UnsafeMode = trueはバインディングを完全に無効にします。これは制御されたシナリオ(例:サーバー間レンダリング)向けに存在します;本番環境ではfalseのままにしてください。
トークンバインディングはこのグローバル UnsafeMode スイッチだけで制御されます — デフォルトでオン(UnsafeMode = false)であり、すべてのセッションに適用されます。ドキュメント単位でのオプトアウトはなく、UnsafeMode = true を設定するとバインディングが全体で無効になります。
アクセス許可と認証ユーザー
UnsafeMode が false の場合、UseDoconut() はページミドルウェアの前に自動的に DocumentAccessMiddleware を挿入します。二度登録しないでください。リクエストがトークンを持つと、ドキュメントが開かれたときに記録された アクセス許可 を検索し、以下すべてが成立する場合にのみ認可します:
- トークンに対する許可が存在すること、
- それが期限切れでないこと(許可の有効期間 = ドキュメントの
TimeOut)、 - 要求側の ASP.NET セッション ID がドキュメントを開いたときのものと一致すること、
- 開いた側が認証済みの場合、要求側ユーザーの
NameIdentifierクレームも一致すること。
失敗時は 403 を返します — ページ/サムネイルリクエストの場合は PNG エラー画像として、その他はプレーンテキストとして。メッセージとトークンのクエリキーは DocumentSecurityOptions から取得されます(TokenQueryKey、デフォルト "token";UnauthorizedMessage、デフォルト "You Are Not Authorized To View This Page.")。これらのオプションはアプリ構築前に ASP.NET Core DI で設定してください。セッション状態が利用できない場合、ミドルウェアは HTTP 500 でクローズドに失敗します:ASP.NET Session is required for Doconut document security.
builder.Services.Configure<Doconut.Security.DocumentSecurityOptions>(options =>
{
options.TokenQueryKey = "token";
options.UnauthorizedMessage = "You Are Not Authorized To View This Page.";
});コアページミドルウェアは、ドキュメントを提供する前に secure-{token} セッションマーカーを検証します。UnsafeMode = true を使用すると、UseDoconut() はアクセスミドルウェアをスキップし、コアマーカーチェックも無効になります。
複数ノード間のセキュリティ
セッションバインドされたトークンは、ページを提供するノードがドキュメントを開いたリクエストも見たことがあると想定します。この想定は、複数のノードが共有ストレージから同じドキュメントを提供する場合には成り立ちません:ページリクエストが開いたことのないノードに届くと、セッション単位のチェックで拒否されます。
答えはドキュメントを無防備にしないことです。AddDoconutDistributedDocumentSecurity(...) を通じて署名付きアクセスチケットを使用すれば、セッションチェックを各ノードが独立して検証できる認証情報に置き換えられます。完全な構成は 分散デプロイ に記載されています。
取り消し
CloseDocument(token) はメモリを解放するだけでなく、secure-{token} マーカーを削除し、アクセス許可を取り消すため、閉じられたトークンは両方のセキュリティ層で即座に無効になります。
本番環境向けチェックリスト
- 単一ノードで
UnsafeMode = false(デフォルト)を保持してください — このグローバルスイッチがトークンをセッションにバインドします。 AddDistributedMemoryCache()を登録してください(MVC と Razor Pages アプリはすでに持っています)およびAddSession()、そして Doconut ミドルウェアブランチの前にapp.UseSession()を呼び出します。- セッションクッキー ポリシーがウィジェットのリクエストでクッキーを送信できるようにしてください(
SameSite、HTTPS)。 - ユーザーがドキュメントを離れる際に
CloseDocumentを使用してください — メモリとセキュリティの両方に利点があります。 - トークンをログに記録したり共有したりしないでください;短命な認証情報として扱ってください。
- 共有ストレージから提供していますか? 無防備なドキュメントを受け入れるのではなく、署名付きアクセスチケットに移行してください。
このページは役に立ちましたか?