Ліцензування
Можливості, рівні ліцензій та сервіс ліцензування
Ця сторінка є довідником під час виконання щодо того, як ліцензія формує поведінку Doconut: що дозволяє кожен стан ліцензії, як надаються можливості та як перевірити все це з коду. (Для завантаження ліцензії дивіться «Початок роботи» → «Налаштування ліцензії».)
Стан ліцензії та їх дії
| Стан | Відкриває документи? | Водяний знак | Можливості |
|---|---|---|---|
| Повна (платна) ліцензія (ця збірка була випущена до дати підписки) | Так | Немає | Ті, що придбані (Has* flags) |
| Тимчасова ліцензія (Developer/NFR — ліцензія оцінки, до дати закінчення терміну) | Так | Немає у базовому переглядачі; вихід плагіну має водяний знак | Всі — загальне надання (фільтр оцінки) |
Прострочена тимчасова ліцензія (після її LicenseExpiry дати) | Так | Водяний знак оцінки | Нічого не надано |
| Відсутній файл ліцензії | Так | Водяний знак оцінки | Нічого не надано |
| Знайдено, але відхилено (недійсний підпис, підробка, у чорному списку, або збірка випущена після дати підписки ліцензії) | Ні — LicenseException при кожному відкритті | — | — |
Платна ліцензія, у якої минула дата підписки, продовжує працювати — без водяного знаку, зі своїми можливостями — на кожній збірці, випущеній до цієї дати. Лише збірка, випущена після неї, відхиляється.
Дві наслідки, які варто усвідомити:
- Відсутня ліцензія не є тимчасовою ліцензією. При відсутності файлу ліцензії сторінки відображаються з водяним знаком, і жодна можливість (пошук, анотація, плагіни) не активна. Повнофункціональний, безводяний досвід вимагає реальної Тимчасової ліцензії (отримати одну).
- Лише відхилена ліцензія блокує відкриття. Прострочена тимчасова ліцензія дозволяє застосунку працювати з водяним знаком оцінки, а платна ліцензія після дати підписки продовжує відображатися без водяного знаку на збірках, які вона покриває; проте розгортання збірки, випущеної після дати підписки ліцензії, відхиляється і швидко завершується з
LicenseException, тому ви виявляєте це під час розгортання — а не тихо відправляючи водяний вихід. Це виключення (зOpenDocumentAsync) містить причину зLicense.RejectionMessage.
Можливості
Doconut обмежує додаткову функціональність за допомогою можливості. Це охоплює вбудовані функції Пошук та Анотація, а також підключені плагіни Converter, Dicom і Signer, кожен з яких надається вашою ліцензією. Базовий переглядач не є можливістю — це передумова, представлена як IsViewerLicensed:
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // non-TRIAL ліцензія присутня ТА охоплює версію цієї збіркиЄдиний пункт контролю, який використовує весь конвеєр, — це IsCapabilityGranted:
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool searchGranted = lic.IsCapabilityGranted(LicenseCapability.Search);Його логіка, дослівно з реалізації: активна (не прострочена) Тимчасова ліцензія надає усі можливості — включаючи можливості, які ще не мають окремого прапорця покупки; реальна придбана ліцензія надає точно свої Has* прапорці і має default-deny для всього, що не зіставлено. (Файл старого типу TRIAL не є правом — його розглядають як неліцензований: з водяним знаком, нічого не надано.)
Тимчасові ліцензії
Тимчасові (Developer/NFR) ліцензії позначаються тегом ExpiryNote і мають жорстку дату закінчення терміну:
| Поле | Значення |
|---|---|
IsTemporary | Тег ExpiryNote присутній (виявлення здійснюється за наявністю тегу — ніколи не порівнюйте з текстом нотатки, це динамічно) |
ExpiryNote | Інформаційний текст, вбудований у ліцензію |
LicenseExpiry | Жорстка дата закінчення терміну (DateTime?) |
Семантика закінчення терміну відрізняється за рівнем: тимчасова ліцензія закінчується у її LicenseExpiry тільки дата (вікно підписки ігнорується; тимчасова ліцензія без дати розглядається як прострочена, безпечний режим). Усі інші ліцензії закінчуються у дату їх підписки/вікна оновлення; для платної ліцензії IsExpired лише повідомляє, що ця дата минула — збірки, випущені до неї, залишаються чистими і зберігають свої можливості.
Довідка IDoconutLicenseService
Впровадьте IDoconutLicenseService (простір імен Doconut.Core.Interfaces; зареєстровано як singleton — ліцензію розбирають один раз під час запуску):
| Поле | Значення |
|---|---|
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 | Один прапорець на можливість: придбаний ліцензією, що покриває цю збірку, або наданий активною Тимчасовою ліцензією. IsCapabilityGranted відповідає на те саме питання за можливістю |
IsValidForDomain(host) | Покриття хоста; ліцензії V4 використовують шаблон *.* |
LicenseRejectionReason | Не порожнє ⇒ відкриття блокується цим повідомленням |
DoconutLicenseInfo надає зручний для відображення знімок для адмін-панелей: Owner, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, прапорці Has*, поля тимчасової ліцензії та RejectionMessage.
// Feature-flag ваш UI з того ж джерела істини, яке використовує SDK
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:
app.MapHealthChecks("/health");Підключіть її до вашого моніторингу, і закінчення підписки стане сповіщенням замість заявки в підтримку. Перевірка повідомляє Unhealthy, коли ліцензія відхилена, або коли IsExpired істинно; для платної ліцензії це означає, що дата підписки минула, і пакет, випущений після неї, буде відхилений — поточна збірка продовжує відображатися чисто.
Оновлення версій
Ліцензія охоплює вікно версії. Оновлення пакету NuGet до збірки новішої, ніж це вікно робить ліцензію недійсною для цієї збірки: IsVersionValid перетворює false і відкриття блокується за допомогою LicenseException (причина в License.RejectionMessage) — навмисне швидке завершення, щоб застаріла або неліцензована збірка була виявлена під час розгортання, а не тихо водяним знаком у виробничому виході. Оновіть підписку, замініть .lic і перезапустіть застосунок, щоб AddDoconut() завантажив нову ліцензію.
Чи була ця сторінка корисною?