ライセンス

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

このページは、ライセンスが Doconut の動作をどのように形作るかについての実行時リファレンスです。各ライセンス状態で何が許可されるか、機能がどのように付与されるか、そしてコードからそれらすべてを確認する方法を説明します。(ライセンスの読み込みについては、ライセンス設定 を参照してください。)

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

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

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

内部で把握すべき2つの結果:

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

機能

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

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

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

csharp
var lic = Doconut.DoconutHost.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)、DoconutHost.Services から取得します。これはシングルトンであり、ライセンスは一度だけ解析され、DoconutHost.Initialize で保持されます:

メンバー意味
License完全な DoconutLicenseInfo スナップショット(以下)
IsTrialレガシーな TRIAL タイプのファイル(未ライセンスとして扱われ、権利ではありません)
IsTemporary / ExpiryNote / LicenseExpiry一時ライセンスマーカー
IsExpired上記のティア規則に従って期限切れ
IsVersionValidこのビルドはライセンスのサポートウィンドウ内です
IsViewerLicensedNon-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
// GET /Features - SDK が使用する同じ真実のソースから UI に機能フラグを設定します
public ActionResult Index()
{
    var lic = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();

    return Json(new
    {
        viewer     = lic.IsViewerLicensed || lic.IsTemporary,
        search     = lic.IsCapabilityGranted(LicenseCapability.Search),
        annotation = lic.IsCapabilityGranted(LicenseCapability.Annotation),
        conversion = lic.HasConverter,
        dicom      = lic.HasDicom,
    }, JsonRequestBehavior.AllowGet);
}

ヘルスチェック

Doconut はライセンス状態を報告する "doconut" ヘルスチェックを登録します。Classic ASP.NET には独自のヘルスエンドポイントがないため、コントローラーから公開します:

csharp
// GET /Health - Doconut は "doconut" ヘルスチェックを登録し、ライセンス状態を報告します:
// 正常 (有効), 劣化 (トライアルまたはライセンスファイルなし), 異常 (拒否または期限切れ)。
public async Task<ActionResult> Index()
{
    var health = Doconut.DoconutHost.Services.GetRequiredService<HealthCheckService>();
    HealthReport report = await health.CheckHealthAsync();

    Response.StatusCode = report.Status == HealthStatus.Unhealthy ? 503 : 200;
    return Content(report.Status.ToString(), "text/plain");
}

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

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

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

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