Лицензирование

Возможности, уровни лицензий и сервис лицензий

Эта страница является справочником во время выполнения о том, как лицензия определяет поведение Doconut: что позволяет каждое состояние лицензии, как предоставляются возможности и как проверить всё это из кода. (Для загрузки лицензии см. Начало работы → Настройка лицензии.)

Состояния лицензий и их функции

СостояниеОткрывает документы?Водяной знакВозможности
Полная (платная) лицензия (эта сборка была выпущена до даты подписки)ДаОтсутствуетПриобретённые (Has* флаги)
Временная лицензия (Developer/NFR — оценочная лицензия, до даты истечения)ДаОтсутствует в базовом просмотрщике; вывод плагина имеет водяной знакВсе — универсальное предоставление (оценочный канал)
Истёкшая временная лицензия (после её LicenseExpiry даты)ДаВодяной знак оценкиНичего не предоставлено
Отсутствует файл лицензииДаВодяной знак оценкиНичего не предоставлено
Найдена, но отклонена (недействительная подпись, изменена, в чёрном списке, или сборка выпущена после даты подписки лицензии)Нет — LicenseException при каждом открытии——

Платная лицензия, у которой прошла дата подписки, продолжает работать — без водяных знаков, со своими возможностями — на любой сборке, выпущенной до этой даты. Только сборка, выпущенная после неё, отклоняется.

Два последствия, которые стоит усвоить:

  • Отсутствующая лицензия не является временной лицензией. При отсутствии файла лицензии страницы отображаются с водяным знаком, и ни одна возможность (поиск, аннотация, плагины) не активна. Полнофункциональный, безводяной опыт требует реальной Временной лицензии (получить её).
  • Только отклонённая лицензия блокирует открытие. Истёкшая Временная лицензия позволяет приложению работать с водяным знаком оценки, а платная лицензия после даты подписки продолжает отображаться без водяных знаков на поддерживаемых сборках; однако развертывание сборки, выпущенной после даты подписки лицензии, отклоняется и быстро завершается с ошибкой LicenseException, поэтому вы обнаруживаете её при развертывании — а не тихо поставляя водяные знаки в выводе. Это исключение (из OpenDocumentAsync) содержит причину из License.RejectionMessage.

Возможности

Doconut ограничивает дополнительный функционал с помощью возможности. Это охватывает встроенные функции Search и Annotation, а также подключаемые плагины Converter, Dicom и Signer, каждый из которых предоставляется вашей лицензией. Базовый просмотрщик не является возможностью — он является предварительным условием, представляемым как IsViewerLicensed:

csharp
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // non-TRIAL лицензия присутствует И покрывает версию этой сборки

Единственный шлюз, который использует весь конвейер, — IsCapabilityGranted:

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

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() загрузил новую лицензию.

Была ли эта страница полезной?