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

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

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

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

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

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

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

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

Можливості

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

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

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

csharp
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.

csharp
// 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 не має власної точки здоров’я, тому відкрийте її через контролер:

csharp
// 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 завантажив нову ліцензію.

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