Ліцензування

Можливості, рівні ліцензій та сервіс ліцензування

Ця сторінка є довідником під час виконання щодо того, як ліцензія формує поведінку Doconut: що дозволяє кожен стан ліцензії, як надаються можливості та як перевірити все це з коду. (Для завантаження ліцензії дивіться Початок роботи → Налаштування ліцензії.)

Стани ліцензії та їх функції

СтанВідкриває документи?Водяний знакМожливості
Повна (платна) ліцензія (ця збірка була випущена до дати підписки)ТакНемаєТі, що придбані (Has* прапорці)
Тимчасова ліцензія (Developer/NFR — ліцензія оцінки, до дати закінчення терміну)ТакНемає у базовому переглядачі; вихід плагіну має водяний знакВсі — загальне надання (оціночна воронка)
Прострочена тимчасова ліцензія (після її LicenseExpiry дати)ТакВодяний знак оцінкиНічого не надано
Відсутній файл ліцензіїТакВодяний знак оцінкиНічого не надано
Знайдено, але відхилено (недійсний підпис, підробка, у чорному списку, або збірка випущена після дати підписки ліцензії)Ні — LicenseException при кожному відкритті——

Платна ліцензія, у якої дата підписки минула, продовжує працювати — без водяного знаку, зі своїми можливостями — на кожній збірці, випущеній до цієї дати. Лише збірка, випущена після неї, відхиляється.

Два наслідки, які варто усвідомити:

  • Відсутня ліцензія не є тимчасовою ліцензією. При відсутності файлу ліцензії сторінки відображаються з водяним знаком, і жодна можливість (пошук, анотації, плагіни) не активна. Повнофункціональний, безводяний досвід вимагає справжньої Тимчасової ліцензії (отримати).
  • Лише відхилена ліцензія блокує відкриття. Прострочена Тимчасова ліцензія дозволяє застосунку працювати з водяним знаком оцінки, а платна ліцензія після дати підписки продовжує відображатися без водяного знаку на збірках, які вона охоплює; проте розгортання збірки, випущеної після дати підписки ліцензії, відхиляється і швидко завершується з LicenseException, тому ви виявляєте це під час розгортання — а не тихо відправляючи водяний вихід. Це виключення (з OpenDocumentAsync) містить причину з License.RejectionMessage.

Можливості

Doconut контролює додаткову функціональність за допомогою можливості. Це охоплює вбудовані функції Пошук та Анотація, а також опціональні плагіни Converter, Dicom і Signer, кожен з яких надається вашою ліцензією. Базовий переглядач не є можливістю — це передумова, представлена як IsViewerLicensed:

csharp
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // non-TRIAL license присутня AND охоплює версію цього збірки

Єдиний контроль, який використовує весь конвеєр, — IsCapabilityGranted:

csharp
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool searchGranted = lic.IsCapabilityGranted(LicenseCapability.Search);

Його логіка, дослівно з реалізації: активна (не прострочена) Тимчасова ліцензія надає кожну можливість — включаючи можливості, які ще не мають окремого прапорця покупки; реальна придбана ліцензія надає точно свої прапорці Has* і має за‑замовчуванням‑відмова для всього, що не зіставлено. (Файл типу TRIAL‑legacy не є правом — його розглядають як неліцензований: з водяним знаком, нічого не надано.)

Тимчасові ліцензії

Тимчасові (Developer/NFR) ліцензії позначаються тегом ExpiryNote і мають жорстку дату закінчення терміну:

ЕлементЗначення
IsTemporaryПрисутній тег ExpiryNote (виявлення здійснюється за наявністю тегу — ніколи не порівнювати з текстом нотатки, це динамічно)
ExpiryNoteІнформаційний текст, вбудований у ліцензію
LicenseExpiryЖорстка дата закінчення терміну (DateTime?)

Семантика закінчення терміну відрізняється за рівнем: тимчасова ліцензія закінчується у свою LicenseExpiry тільки дату (вікно підписки ігнорується; тимчасова ліцензія без дати розглядається як прострочена, безпечний режим). Усі інші ліцензії закінчуються у дату підписки/вікна оновлення; для платної ліцензії IsExpired лише повідомляє, що ця дата минула — збірки, випущені до неї, залишаються чистими і зберігають свої можливості.

Посилання на IDoconutLicenseService

Впровадьте IDoconutLicenseService (простір імен Doconut.Core.Interfaces; зареєстровано як singleton — ліцензію розбирають один раз під час запуску):

ЕлементЗначення
LicenseПовний знімок DoconutLicenseInfo (нижче)
IsTrialФайл типу TRIAL‑legacy (розглядається як неліцензований — не є правом)
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.

csharp
// 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:

csharp
app.MapHealthChecks("/health");

Підключіть її до вашого моніторингу, і закінчення підписки стане сповіщенням, а не заявкою в підтримку. Перевірка повідомляє Unhealthy, коли ліцензія відхилена, або коли IsExpired істинно; для платної ліцензії це означає, що дата підписки минула, і пакет, випущений після неї, буде відхилений — поточна збірка продовжує відображатися без водяного знаку.

Оновлення версій

Ліцензія охоплює вікно версії. Оновлення пакету NuGet до збірки новішої, ніж це вікно, робить ліцензію недійсною для цієї збірки: IsVersionValid перетворює false і відкриття блокується з LicenseException (причина в License.RejectionMessage) — навмисне швидке завершення, щоб застаріла або неліцензована збірка була виявлена під час розгортання, а не тихо водяним знаком у виробничому виході. Оновіть підписку, замініть .lic і перезапустіть застосунок, щоб AddDoconut() завантажив нову ліцензію.

Чи була ця сторінка корисною?