ライセンス
機能、ライセンスタイア、ライセンスサービス
このページは、ライセンスが Doconut の動作をどのように形作るかについての実行時リファレンスです。各ライセンス状態で許可されること、機能がどのように付与されるか、そしてコードからそれらすべてを検査する方法を説明します。（ライセンスのロード方法については、はじめに → ライセンス設定 を参照してください。）
ライセンス状態とその機能
| 状態 | ドキュメントを開くか？ | 透かし | 機能 |
|---|---|---|---|
| フル（有料）ライセンス（サブスクリプション/更新ウィンドウ内） | はい | なし | 購入されたもの（Has* フラグ） |
| 一時ライセンス（Developer/NFR — 評価ライセンス、期限日まで） | はい | なし | すべて — 包括的付与（評価フネル） |
| 期限切れ（期限日を過ぎた一時ライセンス、または更新日を過ぎた有料サブスクリプション） | はい | 評価用透かし | 付与なし |
| ライセンスファイルが全くない | はい | 評価用透かし | 付与なし |
| 見つかったが拒否（無効な署名、改ざん、ブラックリスト登録、またはライセンスのバージョンウィンドウより新しいビルド） | いいえ — LicenseException がすべてのオープン時に発生 | — | — |
覚えておくべき2つの結果：
- ライセンスがないことは一時ライセンスではありません。 ライセンスファイルがない場合、ページは透かしが付いた状態で表示され、機能（検索、注釈、プラグイン）はすべて無効になります。フル機能で透かしのない体験を得るには、実際の 一時ライセンス が必要です（取得する）。
- 拒否されたライセンスだけがオープンをブロックします。 カレンダー/サブスクリプションの期限切れは透かし付き表示に劣化しますが、ビルドがライセンスのバージョンウィンドウ より新しい 場合は拒否され、
LicenseExceptionによって 即座に失敗 します。そのためデプロイ時に捕捉でき、透かし付き出力を黙って出荷することはありません。その例外（OpenDocumentAsyncから）はLicense.RejectionMessageの理由を含みます。
機能
Doconut はオプション機能を 機能（capability）で制御します。現在、オプトインの 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 タイプのファイルは 権利付与 されておらず、未ライセンスとして扱われます：透かしが付き、何も付与されません。）
一時ライセンス
通常の Search と Annotation は既存の機能を直接使用します。
一時（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() が新しいライセンスを読み込むようにします。
このページは役に立ちましたか？