Ліцензування
Можливості, рівні ліцензій та сервіс ліцензування
Ця сторінка є довідником під час виконання щодо того, як ліцензія формує поведінку Doconut: що дозволяє кожен стан ліцензії, як надаються можливості та як перевірити все це з коду. (Для завантаження ліцензії дивіться License Setup.)
Стан ліцензії та їх функції
| Стан | Відкриває документи? | Водяний знак | Можливості |
|---|---|---|---|
| Повна (платна) ліцензія (ця збірка була випущена до дати підписки) | Так | Немає | Ті, що придбані (флаги Has*) |
| Тимчасова ліцензія (Developer/NFR — ліцензія оцінки, до дати закінчення терміну) | Так | Немає у базовому переглядачі; вихід плагіну має водяний знак | Всі — універсальне надання (воронка оцінки) |
Термін дії тимчасової ліцензії минув (після дати LicenseExpiry) | Так | Водяний знак оцінки | Нічого не надано |
| Відсутній файл ліцензії | Так | Водяний знак оцінки | Нічого не надано |
| Знайдено, але відхилено (недійсний підпис, підробка, у чорному списку, або збірка випущена після дати підписки ліцензії) | Ні — LicenseException при кожному відкритті | — | — |
Платна ліцензія, термін підписки якої минув, продовжує працювати — без водяного знаку, зі своїми можливостями — у кожній збірці, випущеній до цієї дати. Тільки збірка, випущена після неї, відхиляється.
Два наслідки, які варто усвідомити:
- Відсутня ліцензія не є тимчасовою ліцензією. При відсутності файлу ліцензії сторінки відображаються з водяним знаком, і жодна можливість (пошук, анотація, плагіни) не активна. Повнофункціональний, безводяний досвід вимагає реальної Тимчасової ліцензії (отримати одну).
- Лише відхилена ліцензія блокує відкриття. Термінова ліцензія, термін якої минув, дозволяє застосунку працювати з водяним знаком оцінки, а платна ліцензія після дати підписки продовжує відображатися без водяного знаку у збірках, які вона охоплює; проте розгортання збірки, випущеної після дати підписки ліцензії, відхиляється і швидко завершується з
LicenseException, тому ви виявляєте це під час розгортання — а не тихо поширюючи водяний вихід. Це виключення (відOpenDocumentAsync) містить причину зLicense.RejectionMessage.
Можливості
Doconut керує додатковою функціональністю за допомогою можливості. Це охоплює вбудовані функції Пошук та Анотація, а також опціональні плагіни Converter, Dicom та Signer, кожен з яких надається вашою ліцензією. Базовий переглядач не є можливістю — це передумова, представлена як IsViewerLicensed:
var lic = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // присутня non-TRIAL ліцензія ТА покриває версію цього збіркиЄдиний шлюз, який використовує весь конвеєр, — це IsCapabilityGranted:
var lic = Doconut.DoconutHost.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 (namespace Doconut.Core.Interfaces) з DoconutHost.Services. Це одинак — ліцензію розбирають один раз, у DoconutHost.Initialize:
| Член | Значення |
|---|---|
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.
// GET /Features - feature-flag ваш UI з того ж джерела істини, яке використовує SDK
public ActionResult Index()
{
var lic = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();
return Json(new
{
viewer = lic.IsViewerLicensed || lic.IsTemporary,
search = lic.IsCapabilityGranted(LicenseCapability.Search),
annotation = lic.IsCapabilityGranted(LicenseCapability.Annotation),
conversion = lic.HasConverter,
dicom = lic.HasDicom,
}, JsonRequestBehavior.AllowGet);
}Перевірка працездатності
Doconut реєструє перевірку працездатності "doconut", яка повідомляє стан ліцензії. Класичний ASP.NET не має власної точки здоров’я, тому відкрийте її через контролер:
// GET /Health - Doconut реєструє "doconut" health check, який повідомляє стан ліцензії:
// Здоровий (дійсний), Погіршений (пробний або відсутній файл ліцензії), Нездоровий (відхилений або прострочений).
public async Task<ActionResult> Index()
{
var health = Doconut.DoconutHost.Services.GetRequiredService<HealthCheckService>();
HealthReport report = await health.CheckHealthAsync();
Response.StatusCode = report.Status == HealthStatus.Unhealthy ? 503 : 200;
return Content(report.Status.ToString(), "text/plain");
}Підключіть її до вашого моніторингу, і закінчення підписки стане сповіщенням замість заявки в підтримку. Перевірка повідомляє Unhealthy, коли ліцензія відхилена, або коли IsExpired істинно; для платної ліцензії це означає, що дата підписки минула, і пакет, випущений після неї, буде відхилений — поточна збірка продовжує рендеритися без помилок. Дивіться DoconutHost для значень статусу.
Оновлення версій
Ліцензія охоплює вікно версії. Оновлення пакету NuGet до збірки новішої, ніж це вікно, робить ліцензію недійсною для цієї збірки: IsVersionValid перетворює false і відкриття блокується за допомогою LicenseException (причина в License.RejectionMessage) — навмисне швидке відмовлення, щоб застаріла або неліцензована збірка була виявлена під час розгортання, а не тихо водяним знаком у продуктивному виводі. Оновіть підписку, замініть .lic у wwwroot і перезапустіть пул застосунків, щоб DoconutHost.Initialize завантажив нову ліцензію.
Чи була ця сторінка корисною?