Лицензирование
Возможности, уровни лицензий и сервис лицензий
Эта страница является справочником во время выполнения о том, как лицензия определяет поведение 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* флаги и имеет 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.
// 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() загрузил новую лицензию.
Была ли эта страница полезной?