Лицензирование
Возможности, уровни лицензий и сервис лицензий
Эта страница — справочник во время выполнения о том, как лицензия определяет поведение Doconut: что позволяет каждое состояние лицензии, как предоставляются возможности и как проверить всё это из кода. (Для загрузки лицензии см. Настройка лицензии.)
Состояния лицензий и их функции
| Состояние | Открывает документы? | Водяной знак | Возможности |
|---|---|---|---|
| Полная (платная) лицензия (эта сборка была выпущена до даты её подписки) | Да | Нет | Приобретённые (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 лицензия присутствует AND покрывающая версию этой сборкиЕдинственный шлюз, который использует весь конвейер, — IsCapabilityGranted:
var lic = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();
bool searchGranted = lic.IsCapabilityGranted(LicenseCapability.Search);Её логика, дословно из реализации: активная (неистёкшая) Временная лицензия предоставляет все возможности — включая те, для которых ещё нет отдельного флага покупки; реальная приобретённая лицензия предоставляет точно свои флаги Has* и имеет по умолчанию отказ для любого не сопоставленного. (Устаревший файл типа TRIAL не является правом — он рассматривается как нелицензированный: с водяным знаком, ничего не предоставлено.)
Временные лицензии
Временные (Developer/NFR) лицензии отмечаются тегом ExpiryNote и имеют жёсткую дату истечения:
| Элемент | Значение |
|---|---|
IsTemporary | Тег ExpiryNote присутствует (обнаружение происходит по наличию тега — никогда не сравнивайте с текстом заметки, это динамично) |
ExpiryNote | Информационный текст, встроенный в лицензию |
LicenseExpiry | Жёсткая дата истечения (DateTime?) |
Семантика истечения зависит от уровня: временная лицензия истекает в соответствии с её LicenseExpiry только датой (окно подписки игнорируется; временная лицензия без даты считается истёкшей, безопасный отказ). Все остальные лицензии истекают по дате их окна подписки/обновления; для платной лицензии IsExpired только сообщает, что эта дата прошла — сборки, выпущенные до неё, остаются чистыми и сохраняют свои возможности.
Ссылка на IDoconutLicenseService
Разрешить IDoconutLicenseService (пространство имён Doconut.Core.Interfaces) из DoconutHost.Services. Это singleton — лицензия разбирается один раз, в 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 - управляйте флагами функций вашего 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", которая сообщает состояние лицензии. У Classic ASP.NET нет собственного эндпоинта состояния, поэтому откройте её через контроллер:
// GET /Health - Doconut регистрирует проверку состояния "doconut", которая сообщает о состоянии лицензии:
// Здоровый (действительный), Ухудшенный (пробный или отсутствует файл лицензии), Нездоровый (отклонён или просрочен).
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 загрузил новую лицензию.
Была ли эта страница полезной?