ライセンス

機能、ライセンス層、そしてライセンスサービス

このページは、ライセンスが Doconut の動作をどのように形作るかについての実行時リファレンスです:各ライセンス状態が許可すること、機能がどのように付与されるか、そしてコードからそれらすべてを検査する方法を説明します。(ライセンスのロード については、Getting Started → License Setup を参照してください。)

ライセンス状態とその機能

状態ドキュメントを開くか?透かし機能
フル(有料)ライセンス(このビルドはサブスクリプション日以前にリリースされました)はいなし購入されたもの(Has* フラグ)
一時ライセンス(Developer/NFR — 評価ライセンス、期限日以前)はいベースビューアではなし;プラグイン出力には透かしが付くすべて — 包括的付与(評価ファンネル)
期限切れの一時ライセンス(LicenseExpiry 日を過ぎた)はい評価透かし付与なし
ライセンスファイルが全くないはい評価透かし付与なし
見つかったが拒否された(無効な署名、改ざん、ブラックリスト、またはライセンスのサブスクリプション日以降にリリースされたビルド)いいえ — LicenseException がすべてのオープンで発生——

サブスクリプション日が過ぎた有料ライセンスは、その日以前にリリースされたすべてのビルドで、クリーンに機能し、機能も保持されます。日付以降にリリースされたビルドだけが拒否されます。

内部化すべき2つの結果:

  • ライセンスがないことは一時ライセンスではありません。 ライセンスファイルがない場合、ページは透かしが付いた状態で表示され、機能(検索、注釈、プラグイン)はすべて無効になります。フル機能で透かしのない体験を得るには、実際の 一時ライセンス が必要です(取得する)。
  • 拒否されたライセンスだけがオープンをブロックします。 期限切れの一時ライセンスは評価透かし付きでアプリを動作させ続け、サブスクリプション日を過ぎた有料ライセンスは対象ビルドでクリーンにレンダリングされます。しかし、ライセンスのサブスクリプション日以降にリリースされたビルドをデプロイすると、拒否され、LicenseException で 即座に失敗 します。そのため、デプロイ時に検出でき、透かし付き出力を静かに出荷することはありません。その例外(OpenDocumentAsync から)は License.RejectionMessage の理由を含みます。

機能

Doconut は 機能 によってオプション機能をゲートします。組み込みの Search と Annotation 機能、およびオプトインの Converter、Dicom、Signer プラグインをカバーし、各々はライセンスによって付与されます。ベースビューアは機能ではなく、前提条件であり、IsViewerLicensed として表面化します:

csharp
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // non-TRIAL ライセンスが存在し、かつこのビルドのバージョンをカバーしています

パイプライン全体で使用される単一のゲートは IsCapabilityGranted です:

csharp
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool searchGranted = lic.IsCapabilityGranted(LicenseCapability.Search);

そのロジックは実装からの逐語的なものです:有効(期限切れでない)一時ライセンスは すべての 機能を付与します — まだ専用の購入フラグがない機能も含みます;実際に購入されたライセンスは正確にその Has* フラグを付与し、未マッピングのものは デフォルトで拒否 されます。(レガシーの TRIAL タイプのファイルは 権利 ではなく、未ライセンスとして扱われます:透かしが付き、何も付与されません。)

一時ライセンス

一時(Developer/NFR)ライセンスは ExpiryNote タグでマークされ、厳格な有効期限日を持ちます:

メンバー意味
IsTemporaryExpiryNote タグが存在します(検出はタグの有無で行われます — 注釈テキストと一致させてはいけません、動的です)
ExpiryNoteライセンスに埋め込まれた情報テキスト
LicenseExpiry厳格な有効期限日(DateTime?)

有効期限の意味は層によって異なります:一時ライセンスは LicenseExpiry の 日付のみ で期限切れになります(サブスクリプションウィンドウは無視されます;日付がない一時ライセンスは期限切れとして扱われ、フェイルセーフになります)。他のすべてのライセンスはサブスクリプション/更新ウィンドウの日付で期限切れになります;有料ライセンスの場合、IsExpired はこの日付が過ぎたことだけを報告します — それ以前にリリースされたビルドはクリーンに保たれ、機能を保持します。

IDoconutLicenseService リファレンス

IDoconutLicenseService を注入します(名前空間 Doconut.Core.Interfaces;シングルトンとして登録 — ライセンスは起動時に一度だけ解析されます):

メンバー意味
License完全な DoconutLicenseInfo スナップショット(以下)
IsTrialレガシーの TRIAL タイプのファイル(未ライセンスとして扱われます — 権利ではありません)
IsTemporary / ExpiryNote / LicenseExpiry一時ライセンスのマーカー
IsExpired上記の層ルールに従い期限切れ
IsVersionValidこのビルドはライセンスのサポートウィンドウ内です
IsViewerLicensed非 TRIAL ファイルが見つかり、バージョンがカバーされている — ベース前提条件
IsCapabilityGranted(cap)単一の機能ゲート
HasSearch HasAnnotation HasEditor HasConverter HasDicom HasDocumentTools HasSigner HasRedactor HasComparer HasForms HasProtector HasCompressor機能ごとのフラグ1つ:このビルドをカバーするライセンスで購入されたか、アクティブな一時ライセンスで付与されます。IsCapabilityGranted は機能別に同じ質問に答えます
IsValidForDomain(host)ホストカバレッジ;V4 ライセンスはワイルドカード *.* を使用します
LicenseRejectionReason空でない ⇒ このメッセージでオープンがブロックされます

DoconutLicenseInfo は管理パネル向けの表示フレンドリーなスナップショットを公開します:Owner、LicenseType、Domain、IsLicenseFileFound、IsVersionValid、IsTrial、IsExpired、Has* フラグ、一時ライセンスフィールド、そして RejectionMessage。

csharp
// SDK が使用する同じ真実のソースから UI を Feature-flag してください
app.MapGet("/api/features", (IDoconutLicenseService lic) => Results.Ok(new
{
    viewer     = lic.IsViewerLicensed || lic.IsTemporary,
    search     = lic.IsCapabilityGranted(LicenseCapability.Search),
    annotation = lic.IsCapabilityGranted(LicenseCapability.Annotation),
    conversion = lic.HasConverter,
    dicom      = lic.HasDicom,
}));

ヘルスチェック

AddDoconut() は標準の ASP.NET Core メカニズムを通じてライセンス/有効期限状態を報告する "doconut" ヘルスチェックを登録します:

csharp
app.MapHealthChecks("/health");

これを監視に組み込み、期限切れのサブスクリプションはサポートチケットではなくアラートになります。チェックはライセンスが拒否されたとき、または IsExpired が true のときに Unhealthy を報告します;有料ライセンスの場合、これはサブスクリプション日が過ぎ、以降にリリースされたパッケージが拒否されることを意味し、現在のビルドはクリーンにレンダリングされ続けます。

バージョンアップグレード

ライセンスは バージョンウィンドウ をカバーします。NuGet パッケージをそのウィンドウ より新しい ビルドに更新すると、ライセンスはこのビルドに対して無効になります:IsVersionValid が false に変わり、LicenseException で オープンがブロック されます(理由は License.RejectionMessage にあります)— 故意に即座に失敗させ、古いまたは未ライセンスのビルドがデプロイ時に検出され、製品出力に透かしが静かに付くことを防ぎます。サブスクリプションを更新し、.lic を置き換え、アプリケーションを再起動して AddDoconut() が新しいライセンスをロードするようにします。

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