Налаштування ліцензії
Де Doconut шукає ваш файл ліцензії
Без ліцензії Doconut все одно відображає документи — кожна сторінка лише містить водяний знак оцінки. На цій сторінці розглядаються чотири способи надання ліцензії та точний порядок пріоритету, коли встановлено більше одного.
Чотири способи надання ліцензії
Існує чотири: три явних джерела на DoconutOptions — потік, сирий вміст або шлях до файлу — плюс автоматичне виявлення, коли жодне з них не встановлено. Коли встановлено більше одного, порядок пріоритету є точним:
LicenseStream перевершує LicenseContent перевершує LicensePath перевершує автоматичний пошук.
За шляхом
LicensePath передається до File.Exists точно так, як вказано. Відносний шлях розв'язується відносно поточної робочої директорії процесу — не вашої папки проєкту і не папки, в якій знаходиться Program.cs. Якщо шлях не розв'язується, Doconut не викидає виключення і не переходить до автоматичного пошуку — він просто не завантажує ліцензію, і переглядач додає водяний знак. Автоматичний пошук виконується лише коли жодне з LicensePath, LicenseContent або LicenseStream не встановлено. Файли ліцензій для кожного плагіна в тій же папці (Doconut.Viewer.<Capability>.lic) читаються разом з ним, тому LicensePath і AddPlugin<...>() працюють разом, коли ліцензії плагінів розташовані поруч з базовою ліцензією.
Віддавайте перевагу абсолютному шляху (наприклад, сформованому з IWebHostEnvironment.WebRootPath або AppContext.BaseDirectory), або повністю пропустіть LicensePath і покладайтеся на автоматичне виявлення нижче.
builder.Services.AddDoconut(options =>
{
options.LicensePath = Path.Combine(AppContext.BaseDirectory, "wwwroot", "Doconut.Viewer.lic");
});За потоком
LicenseStream читається один раз під час запуску — це корисно, коли ліцензія надходить із сховища секретів, а не з файлу на диску.
// Пріоритет: LicenseStream > LicenseContent > LicensePath > авто‑пошук.
builder.Services.AddDoconut(options =>
{
options.LicenseStream = licenseStream;
});За вмістом
LicenseContent приймає сам текст ліцензії — з змінної середовища, бази даних або менеджера секретів:
// XML ліцензії з бази даних, змінної середовища або менеджера секретів —
// немає файлу на диску. Переможений лише LicenseStream.
builder.Services.AddDoconut(options =>
{
options.LicenseContent = Environment.GetEnvironmentVariable("DOCONUT_LICENSE") ?? "";
});Автоматичне виявлення
Не налаштовуйте жодне з трьох явних джерел, і Doconut сам шукає ліцензію:
// Не налаштовуйте нічого, і Doconut сам шукає ліцензію лише в цих двох папках:
// 1. {CurrentDirectory}/wwwroot
// 2. {AppContext.BaseDirectory}/wwwroot (wwwroot всередині папки вихідних файлів збірки)
// Спочатку шукає Doconut.lic; якщо його немає, Doconut.Viewer.lic та будь‑які
// файли per-plugin Doconut.Viewer.<Capability>.lic.
builder.Services.AddDoconut();Папки для пошуку, у порядку, та імена файлів, які шукаються:
1. {CurrentDirectory}/wwwroot
2. {AppContext.BaseDirectory}/wwwroot
Filenames, in order (each one looked for in folder 1, then folder 2):
Doconut.lic — legacy all-in-one license; if found, nothing else is read
Doconut.Viewer.lic — base viewer license
Doconut.Viewer.<Capability>.lic — per-plugin licenses, read only when Doconut.Viewer.lic was foundНічого поза папкою wwwroot не читається: .lic у самій вихідній папці або у wwwroot/lib ігнорується.
Скопіюйте ліцензію у вашу вихідну папку
Коли процес не запускається з папки проєкту — опублікованого застосунку, IIS, контейнера, тестового раннера — перший пошук не вдається, і другий, {AppContext.BaseDirectory}/wwwroot, має знайти файл. Ця ціль MSBuild копіює ліцензії туди при кожному збірці:
<Target Name="CopyLicensesToOutput" AfterTargets="Build">
<ItemGroup>
<DoconutLicenseFiles Include="$(MSBuildProjectDirectory)\wwwroot\*.lic" />
<StaleOutputLicenses Include="$(OutDir)wwwroot\*.lic" />
</ItemGroup>
<!-- Спочатку видаліть, щоб перейменування або видалення .lic у wwwroot також вилучало його з вихідних даних. -->
<Delete Files="@(StaleOutputLicenses)" />
<Copy SourceFiles="@(DoconutLicenseFiles)" DestinationFolder="$(OutDir)wwwroot" />
</Target>Призначення має бути $(OutDir)wwwroot: .lic, скопійований у корінь вихідної папки, ніколи не буде знайдений автоматичним пошуком. Приклади LicensePath на цій сторінці вказують на те саме місце.
Тримайте файли
.licпоза системою контролю версій — розгорніть їх разом із застосунком або впровадьте ліцензію черезLicenseContentабоLicenseStreamз вашого сховища секретів.
Що відбувається без ліцензії
Відсутня ліцензія не викликає виключення. AddDoconut() успішно виконується, застосунок запускається, і переглядач працює — проте кожна сторінка містить водяний знак оцінки і жодна додаткова можливість не надається.
Файл ліцензії, який знайдено, але відхилено, — інша справа. Недійсний підпис, підробка, чорний список або збірка поза вікном версії ліцензії спричиняє, що OpenDocumentAsync викидає LicenseException з License.RejectionMessage. Термінова ліцензія, термін якої минув, продовжує працювати у режимі з водяним знаком. Платна ліцензія, у якої дата підписки минула, продовжує працювати, чистою і зі своїми можливостями, у кожній збірці, випущеній до цієї дати.
Плагінам потрібні можливості
Реєстрація плагіна без відповідного права є іншим випадком: при відсутній ліцензії, застарілому файлі TRIAL або платній ліцензії без цієї можливості, AddDoconut() викидає InvalidOperationException, тому застосунок не запускається. Наприклад, реєстрація плагіна Converter без ліцензії, що надає Converter:
InvalidOperationException: The Converter plugin is registered via AddPlugin but no active
license grants Converter. Remove the AddPlugin<...>() call or install a license (or
trial/demo) that includes Converter.Повідомлення одразу підказує рішення: або видалити виклик options.AddPlugin<...>() для цього плагіна, або встановити платну ліцензію чи активну Термінову/Демо (NFR) ліцензію, що надає цю можливість. Термінові реєстрації дозволено залишатися після дати закінчення, щоб вже налаштований застосунок міг деградувати під час виконання замість аварійного завершення під час перезапуску; після закінчення їхні можливості все одно відкликаються.
Перевірка завантаженої ліцензії
Використовуйте IDoconutLicenseService, той самий джерело правди, що використовується SDK, щоб надати автентифікований діагностичний кінцевий пункт або керувати прапорцями функцій. Не повертайте вміст ліцензії чи ключі.
app.MapGet("/api/doconut/license", (IDoconutLicenseService license) => Results.Ok(new
{
viewer = license.IsViewerLicensed || license.IsTemporary,
temporary = license.IsTemporary,
search = license.IsCapabilityGranted(LicenseCapability.Search),
annotation = license.IsCapabilityGranted(LicenseCapability.Annotation),
converter = license.HasConverter,
dicom = license.HasDicom
}));Ліцензія читається під час реєстрації AddDoconut(). ResetLicense наразі є властивістю сумісності без активного шляху перезавантаження, тому заміна файлу ліцензії вимагає перезапуску застосунку.
Матриця усунення неполадок
| Симптом | Ймовірна причина | Перевірка |
|---|---|---|
| Переглядач працює, але кожна сторінка має водяний знак | Не була завантажена ліцензія, або Термінова ліцензія прострочена | Вирішіть IDoconutLicenseService; перевірте вихідний каталог і робочий каталог процесу |
AddDoconut() викидає для плагіна | Ліцензія не надає цю можливість плагіну | Перевірте IsCapabilityGranted(...) і видаліть реєстрації, які ви не придбали |
| Налаштований відносний шлях працює локально, але не в IIS/контейнері | Робочий каталог процесу змінився | Використайте AppContext.BaseDirectory або абсолютний шлях |
Замінений файл .lic не має ефекту | Сервіс ліцензії-одиночка вже був створений | Перезапустіть застосунок |
OpenDocumentAsync викидає LicenseException | Підпис, домен, вікно версії, чорний список або ворота виконання плагіна відхилили ліцензію | Прочитайте повідомлення про виключення/відхилення, не розкриваючи його недовіреним клієнтам |
Наступні кроки
- Ліцензування — можливості, рівні ліцензій та перевірка того, що завантажено під час виконання.
- Усунення неполадок — водяні знаки, відхилені ліцензії та помилки можливостей.
Чи була ця сторінка корисною?