Лицензирование
Возможности, уровни лицензий и сервис лицензий
Эта страница — справочник во время выполнения о том, как лицензия определяет поведение Doconut: что позволяет каждое состояние лицензии, как предоставляются возможности и как проверить всё это из кода. (Для загрузки лицензии см. Руководство → Настройка лицензии.)
Состояния лицензии и их функции
| Состояние | Открывает документы? | Водяной знак | Возможности |
|---|---|---|---|
| Полная (платная) лицензия (эта сборка была выпущена до даты подписки) | Да | Отсутствует | Приобретённые (Has* флаги) |
| Временная лицензия (Developer/NFR — оценочная лицензия, до даты истечения) | Да | Отсутствует в базовом просмотрщике; вывод плагина имеет водяной знак | Все — безусловное предоставление (оценочный канал) |
Истёкшая временная лицензия (после даты LicenseExpiry) | Да | Оценочный водяной знак | Ничего не предоставлено |
| Отсутствует файл лицензии | Да | Оценочный водяной знак | Ничего не предоставлено |
| Найдена, но отклонена (недействительная подпись, изменена, в чёрном списке, или сборка, выпущенная после даты подписки лицензии) | Нет — LicenseException при каждом открытии | — | — |
Платная лицензия, у которой прошла дата подписки, продолжает работать — без водяных знаков, со своими возможностями — на любой сборке, выпущенной до этой даты. Только сборка, выпущенная после неё, отклоняется.
Два последствия, которые стоит усвоить:
- Отсутствие лицензии не является временной лицензией. При отсутствии файла лицензии страницы отображаются с водяным знаком, и ни одна возможность (поиск, аннотации, плагины) не активна. Полнофункциональный, безводяной опыт требует реальной Временной лицензии (получить её).
- Только отклонённая лицензия блокирует открытие. Истёкшая Временная лицензия позволяет приложению работать с оценочным водяным знаком, а платная лицензия после даты подписки продолжает отображаться без водяных знаков на поддерживаемых сборках; однако развертывание сборки, выпущенной после даты подписки лицензии, отклоняется и быстро завершается с ошибкой через
LicenseException, поэтому вы обнаруживаете её при развертывании — а не тихо поставляя водяные знаки в выводе. Это исключение (изOpenDocumentAsync) содержит причину изLicense.RejectionMessage.
Возможности
Doconut ограничивает дополнительный функционал через возможность. Это охватывает встроенные функции Search и Annotation, а также подключаемые плагины Converter, Dicom и Signer, каждый из которых предоставляется вашей лицензией. Базовый просмотрщик не является возможностью — это предварительное условие, представляемое как IsViewerLicensed:
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // non-TRIAL лицензия присутствует И покрывает версию этой сборкиЕдинственный шлюз, который использует весь конвейер, — IsCapabilityGranted:
var lic = app.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; зарегистрировано как 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.
// 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:
app.MapHealthChecks("/health");Подключите её к вашей системе мониторинга, и истекающая подписка превратится в оповещение вместо заявки в поддержку. Проверка сообщает Unhealthy, когда лицензия отклонена, или когда IsExpired истинно; для платной лицензии это означает, что дата подписки прошла и пакет, выпущенный после неё, будет отклонён — текущая сборка продолжает отображаться чистой.
Обновления версии
Лицензия покрывает окно версии. Обновление пакета NuGet до сборки новее, чем это окно, делает лицензию недействительной для этой сборки: IsVersionValid превращает false и открытие блокируется с помощью LicenseException (причина указана в License.RejectionMessage) — преднамеренно быстрое завершение с ошибкой, чтобы устаревшая или без лицензии сборка была обнаружена при развертывании, а не тихо водяным знаком помечала продуктивный вывод. Обновите подписку, замените .lic и перезапустите приложение, чтобы AddDoconut() загрузил новую лицензию.
Была ли эта страница полезной?