Лицензирование
Возможности, уровни лицензий и сервис лицензий
Эта страница — справочник во время выполнения о том, как лицензия определяет поведение Doconut: что позволяет каждое состояние лицензии, как предоставляются возможности и как проверить всё это из кода. (Для загрузки лицензии см. Руководство → Настройка лицензии.)
Состояния лицензий и их функции
| Состояние | Открывает документы? | Водяной знак | Возможности |
|---|---|---|---|
| Полная (платная) лицензия (эта сборка была выпущена до даты её подписки) | Да | Нет | Приобретённые (Has* flags) |
| Временная лицензия (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* флаги и имеет default-deny для любого не сопоставленного. (Устаревший файл типа TRIAL не является правом — он рассматривается как без лицензии: с водяным знаком, ничего не предоставлено.)
Временные лицензии
Временные (Developer/NFR) лицензии отмечаются тегом ExpiryNote и имеют жёсткую дату истечения:
| Элемент | Значение |
|---|---|
IsTemporary | Присутствует тег ExpiryNote (обнаружение происходит по наличию тега — никогда не сравнивать с текстом заметки, это динамично) |
ExpiryNote | Информационный текст, встроенный в лицензию |
LicenseExpiry | Жёсткая дата истечения (DateTime?) |
Семантика истечения различается по уровням: временная лицензия истекает только по её LicenseExpiry дате (окно подписки игнорируется; временная лицензия без даты считается истёкшей, безопасный отказ). Все остальные лицензии истекают по дате их окна подписки/обновления; для платной лицензии IsExpired лишь сообщает, что эта дата прошла — сборки, выпущенные до неё, остаются чистыми и сохраняют свои возможности.
Ссылка на IDoconutLicenseService
Внедрите IDoconutLicenseService (пространство имён Doconut.Core.Interfaces; зарегистрировано как синглтон — лицензия разбирается один раз при запуске):
| Элемент | Значение |
|---|---|
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() загрузил новую лицензию.
Была ли эта страница полезной?