ライセンス

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

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

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

状態ドキュメントを開くか?透かし機能
フル(有料)ライセンス(このビルドはサブスクリプション日以前にリリースされた)はいなし購入されたもの(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
// Feature-flag を使用して、SDK が使用する同じ真実のソースから UI を制御します
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() は "doconut" ヘルスチェックを登録し、標準の ASP.NET Core メカニズムを通じてライセンス/有効期限状態を報告します:

csharp
app.MapHealthChecks("/health");

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

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

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

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