ライセンス
機能、ライセンス階層、ライセンスサービス
このページは、ライセンスが Doconut の動作をどのように形作るかについての実行時リファレンスです。各ライセンス状態で許可されること、機能がどのように付与されるか、そしてコードからそれらすべてを確認する方法を説明します。（ライセンスのロードについては、はじめに → ライセンス設定 を参照してください。）
ライセンス状態とその機能
| 状態 | ドキュメントを開くか？ | 透かし | 機能 |
|---|---|---|---|
| フル（有料）ライセンス（サブスクリプション/更新ウィンドウ内） | はい | なし | 購入されたもの（Has* フラグ） |
| 一時ライセンス（Developer/NFR — 評価ライセンス、期限日まで） | はい | なし | すべて — 包括的付与（評価フネル） |
| 期限切れ（期限日を過ぎた一時ライセンス、または更新日を過ぎた有料サブスクリプション） | はい | 評価用透かし | 付与なし |
| ライセンスファイルなし | はい | 評価用透かし | 付与なし |
| 見つかったが拒否（無効な署名、改ざん、ブラックリスト登録、またはライセンスのバージョンウィンドウより新しいビルド） | いいえ — LicenseException がすべてのオープンで発生 | — | — |
覚えておくべき2つの結果：
- ライセンスがないことは一時ライセンスではありません。 ライセンスファイルがない場合、ページは透かし付きで表示され、機能（検索、注釈、プラグイン）はすべて無効になります。フル機能で透かしのない体験を得るには、実際の 一時ライセンス が必要です（取得する）。
- 拒否されたライセンスだけがオープンをブロックします。 カレンダー/サブスクリプションの期限切れは透かし付き表示に劣化しますが、ビルドがライセンスのバージョンウィンドウ より新しい 場合は拒否され、
LicenseExceptionによって 即座に失敗 します。そのためデプロイ時に捕捉でき、透かし付き出力を静かに出荷することはありません。その例外（OpenDocumentAsyncから）はLicense.RejectionMessageの理由を保持しています。
機能
Doconut は 機能 によってオプション機能を制御します。現在、オプトインの Converter と DICOM プラグイン、そして組み込みの Search と Annotation 機能があり、いずれもライセンスによって付与されます。ベースビューアは機能ではなく、前提条件であり、IsViewerLicensed として表されます：
bool viewerLicensed = lic.IsViewerLicensed; // non-TRIAL license present AND covering this build's versionパイプライン全体で使用される単一のゲートは IsCapabilityGranted です：
bool searchGranted = lic.IsCapabilityGranted(LicenseCapability.Search);そのロジックは実装からそのまま抜粋したものです。アクティブ（期限切れでない）一時 ライセンスは すべての 機能を付与します — まだ専用の購入フラグがない機能も含みます。実際に購入されたライセンスは Has* フラグ通りに付与し、未マッピングのものは デフォルトで拒否 されます。（レガシーな TRIAL タイプのファイルは 権利 ではなく、未ライセンス扱いとなり、透かしが付き、何も付与されません。）
一時ライセンス
一時（Developer/NFR）ライセンスは ExpiryNote タグでマークされ、厳格な有効期限を持ちます：
| メンバー | 意味 |
|---|---|
IsTemporary | ExpiryNote タグが存在する（検出はタグの有無で行い、ノートのテキストは一致させず、動的です） |
ExpiryNote | ライセンスに埋め込まれた情報テキスト |
LicenseExpiry | 厳格な有効期限（DateTime?） |
有効期限の意味は階層によって異なります：一時ライセンスは LicenseExpiry の 日付のみ で期限切れになります（サブスクリプションウィンドウは無視されます。日付がない一時ライセンスは期限切れとして扱われ、フェイルセーフになります）。他のすべてのライセンスはサブスクリプション/更新ウィンドウの日付で期限切れになります。
IDoconutLicenseService リファレンス
IDoconutLicenseService を注入します（名前空間 Doconut.Core.Interfaces；シングルトンとして登録 — ライセンスは起動時に一度だけ解析されます）：
| メンバー | 意味 |
|---|---|
License | 完全な DoconutLicenseInfo スナップショット（以下） |
IsTrial | レガシーな TRIAL タイプのファイル（未ライセンスとして扱われ、権利ではありません） |
IsTemporary / ExpiryNote / LicenseExpiry | 一時ライセンスのマーカー |
IsExpired | 上記の階層ルールに基づく期限切れ |
IsVersionValid | このビルドはライセンスのサポートウィンドウ内にあります |
IsViewerLicensed | 非 TRIAL ファイルが見つかり、バージョンがカバーされている — 基本前提条件 |
IsCapabilityGranted(cap) | 単一の機能ゲート |
HasSearch HasAnnotation HasConverter HasDicom | 機能ごとの購入フラグに基づいてリリース — 一時ライセンス対応の回答には IsCapabilityGranted を使用してください |
IsValidForDomain(host) | ホストカバレッジ；V4 ライセンスはワイルドカード *.* を使用 |
LicenseRejectionReason | 空でない場合 ⇒ このメッセージでオープンがブロックされます |
DoconutLicenseInfo は管理パネル向けの表示フレンドリーなスナップショットを公開します：Owner、Email、LicenseType、Domain、IsLicenseFileFound、IsVersionValid、IsTrial、IsExpired、Has* フラグ、一時ライセンスのフィールド、そして RejectionMessage。
// Feature-flag your UI from the same source of truth the SDK uses
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" ヘルスチェックを登録します：
app.MapHealthChecks("/health");これを監視に組み込めば、期限切れが近づくサブスクリプションはサポートチケットではなくアラートになります。
バージョンアップグレード
ライセンスは バージョンウィンドウ をカバーします。そのウィンドウより 新しい ビルドに NuGet パッケージを更新すると、ライセンスはこのビルドに対して無効になります：IsVersionValid が false になり、LicenseException によって オープンがブロック されます（理由は License.RejectionMessage にあります）— 故意に即座に失敗させることで、古いまたは未ライセンスのビルドがデプロイ時に捕捉され、プロダクション出力が静かに透かし付けられることを防ぎます。サブスクリプションを更新し、.lic を置き換えてアプリケーションを再起動すれば、AddDoconut() が新しいライセンスをロードします。
このページは役に立ちましたか？