Konfiguracja licencji
Gdzie Doconut szuka pliku licencji
Bez licencji Doconut nadal renderuje dokumenty — każda strona zawiera znak wodny oceny. Ta strona opisuje cztery sposoby dostarczenia licencji oraz dokładny priorytet, gdy ustawionych jest więcej niż jeden.
Licencja jest ładowana jednokrotnie, podczas AddDoconut(). To zmiana w stosunku do poprzedniej biblioteki .NET Standard, gdzie licencja była przekazywana do instancji Viewer lub ustawiana poprzez statyczne wywołania Viewer.DoconutLicense(...) / Viewer.SetLicensePlugin(...). Te metody nie są mechanizmem uruchamiania w tej wersji — zobacz przewodnik migracji.
Cztery sposoby dostarczenia licencji
Istnieją cztery: trzy explicite źródła w DoconutOptions — strumień, surowa treść lub ścieżka do pliku — oraz automatyczne wykrywanie, gdy żadne z nich nie jest ustawione. Gdy ustawionych jest więcej niż jedno, priorytet jest następujący:
LicenseStream przeważa nad LicenseContent przeważa nad LicensePath przeważa nad automatycznym wyszukiwaniem.
Według ścieżki
LicensePath jest przekazywany do File.Exists dokładnie tak, jak podano. Ścieżka względna jest rozwiązywana względem procesu bieżącego katalogu roboczego — nie folderu projektu, ani folderu, w którym znajduje się Program.cs. Jeśli ścieżka nie zostanie znaleziona, Doconut nie zgłasza wyjątku i nie przechodzi do automatycznego wyszukiwania — po prostu nie ładuje żadnej licencji i podgląd zostaje oznaczony znakiem wodnym. Automatyczne wyszukiwanie uruchamia się tylko wtedy, gdy żadne z LicensePath, LicenseContent lub LicenseStream nie jest ustawione. Pliki licencji per‑plugin w tym samym folderze (Doconut.Viewer.<Capability>.lic) są odczytywane razem, więc LicensePath i AddPlugin<...>() działają razem, gdy licencje wtyczek znajdują się obok głównej licencji.
Preferuj ścieżkę bezwzględną (na przykład zbudowaną z IWebHostEnvironment.WebRootPath lub AppContext.BaseDirectory), lub całkowicie pomiń LicensePath i polegaj na automatycznym wykrywaniu poniżej.
builder.Services.AddDoconut(options =>
{
options.LicensePath = Path.Combine(AppContext.BaseDirectory, "wwwroot", "Doconut.Viewer.lic");
});Według strumienia
LicenseStream jest odczytywany jednokrotnie przy uruchomieniu — przydatny, gdy licencja pochodzi z tajnego magazynu, a nie z pliku na dysku.
// Priorytet: LicenseStream > LicenseContent > LicensePath > auto-wyszukiwanie.
builder.Services.AddDoconut(options =>
{
options.LicenseStream = licenseStream;
});Według treści
LicenseContent przyjmuje sam tekst licencji — z zmiennej środowiskowej, bazy danych lub menedżera tajemnic:
// XML licencji z bazy danych, zmiennej środowiskowej lub menedżera sekretów —
// brak pliku na dysku. Pokonany tylko przez LicenseStream.
builder.Services.AddDoconut(options =>
{
options.LicenseContent = Environment.GetEnvironmentVariable("DOCONUT_LICENSE") ?? "";
});Automatyczne wykrywanie
Nie skonfiguruj żadnego z trzech explicite źródeł, a Doconut sam wyszuka licencję:
// Nie konfiguruj niczego, a Doconut sam wyszukuje licencję, tylko w tych dwóch folderach:
// 1. {CurrentDirectory}/wwwroot
// 2. {AppContext.BaseDirectory}/wwwroot (wwwroot wewnątrz folderu wyjściowego kompilacji)
// Najpierw szuka Doconut.lic; jeśli go brak, Doconut.Viewer.lic oraz
// pliki Doconut.Viewer.<Capability>.lic zależne od możliwości.
builder.Services.AddDoconut();Foldery sondowania, w kolejności, oraz nazwy plików, które są poszukiwane:
Jeśli zostanie znaleziona starsza licencja zawierająca wszystkie informacje, nie zostanie odczytany żaden inny plik.
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-capability licenses, read only when Doconut.Viewer.lic was foundNic poza folderem wwwroot nie jest odczytywane: .lic w samym folderze wyjściowym lub w wwwroot/lib jest ignorowane.
Jeśli wcześniej przekazałeś List<string> ścieżek licencji do konstruktora Viewer — po jednej na możliwość — zachowaj te pliki towarzyszące obok Doconut.Viewer.lic i pozwól automatycznemu wykrywaniu je pobrać. Opcja listy ścieżek nie istnieje w DoconutOptions.
Skopiuj licencję do folderu wyjściowego
Kiedy proces nie jest uruchamiany z folderu projektu — opublikowana aplikacja, IIS, kontener, uruchamiacz testów — pierwsze sprawdzenie nie znajduje pliku, a drugie, {AppContext.BaseDirectory}/wwwroot, musi go odnaleźć. Ten cel MSBuild kopiuje licencje tam przy każdym kompilowaniu:
<Target Name="CopyLicensesToOutput" AfterTargets="Build">
<ItemGroup>
<DoconutLicenseFiles Include="$(MSBuildProjectDirectory)\wwwroot\*.lic" />
<StaleOutputLicenses Include="$(OutDir)wwwroot\*.lic" />
</ItemGroup>
<!-- Najpierw usuń, aby zmiana nazwy lub usunięcie pliku .lic w wwwroot również usunęło go z wyjścia. -->
<Delete Files="@(StaleOutputLicenses)" />
<Copy SourceFiles="@(DoconutLicenseFiles)" DestinationFolder="$(OutDir)wwwroot" />
</Target>Miejsce docelowe musi być $(OutDir)wwwroot: .lic skopiowany do katalogu wyjściowego nigdy nie zostanie znaleziony przez automatyczne wyszukiwanie. Przykłady LicensePath na tej stronie wskazują to samo miejsce.
Trzymaj pliki
.licpoza kontrolą wersji — wdrażaj je razem z aplikacją lub wstrzykuj licencję przezLicenseContentlubLicenseStreamz twojego magazynu tajemnic.
Co się dzieje bez licencji
Brak licencji nie powoduje wyjątku. AddDoconut() kończy się powodzeniem, aplikacja się uruchamia, a przeglądarka działa — jednak każda strona zawiera znak wodny oceny i nie przyznano żadnych opcjonalnych funkcji.
Plik licencji, który zostanie znaleziony, ale odrzucony, to inna sytuacja. Nieprawidłowy podpis, manipulacja, czarna lista lub kompilacja poza okresem wersji licencji powodują, że OpenDocumentAsync rzuca LicenseException z License.RejectionMessage. Wygasła tymczasowa licencja działa dalej w trybie z znakiem wodnym. Płatna licencja, której data subskrypcji minęła, nadal działa, czysta i z pełnymi możliwościami, przy każdej kompilacji wydanej przed tą datą.
Wtyczki wymagają uprawnień
Rejestrowanie wtyczki bez odpowiedniego uprawnienia jest inne: przy brakującej licencji, starszym pliku TRIAL lub płatnej licencji bez tej funkcji, AddDoconut() rzuca InvalidOperationException, więc aplikacja się nie uruchamia. Na przykład, rejestracja wtyczki Converter bez licencji przyznającej 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.Komunikat podaje rozwiązanie od razu: albo usuń wywołanie options.AddPlugin<...>() dla tej wtyczki, albo zainstaluj płatną licencję lub aktywną tymczasową/licencję demonstracyjną (NFR), która przyznaje tę funkcję. Tymczasowe rejestracje mogą przetrwać po dacie wygaśnięcia, aby już skonfigurowana aplikacja mogła przejść w tryb degradacji w czasie działania zamiast awarii przy ponownym uruchomieniu; po wygaśnięciu ich możliwości są nadal cofane.
Zweryfikuj załadowaną licencję
Użyj IDoconutLicenseService, tego samego źródła prawdy używanego przez SDK, aby udostępnić uwierzytelniony punkt diagnostyczny lub sterować flagami funkcji. Nie zwracaj treści licencji ani kluczy.
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
}));Licencja jest odczytywana podczas rejestracji AddDoconut(). ResetLicense jest obecnie właściwością kompatybilności bez aktywnej ścieżki przeładowania, więc zastąpienie pliku licencji wymaga ponownego uruchomienia aplikacji.
Macierz rozwiązywania problemów
| Objaw | Prawdopodobna przyczyna | Sprawdź |
|---|---|---|
| Przeglądarka działa, ale każda strona ma znak wodny | Nie załadowano licencji lub tymczasowa licencja wygasła | Rozwiąż IDoconutLicenseService; zweryfikuj katalog wyjściowy i katalog roboczy procesu |
AddDoconut() rzuca wyjątek dla wtyczki | Licencja nie przyznaje tej wtyczce uprawnienia | Sprawdź IsCapabilityGranted(...) i usuń rejestracje, których nie zakupiłeś |
| Skonfigurowana ścieżka względna działa lokalnie, ale nie w IIS/kontenerze | Katalog roboczy procesu się zmienił | Użyj AppContext.BaseDirectory lub ścieżki bezwzględnej |
Zastąpiony plik .lic nie ma efektu | Jednostkowa usługa licencji została już utworzona | Uruchom ponownie aplikację |
OpenDocumentAsync rzuca LicenseException | Podpis, domena, okno wersji, czarna lista lub bramka czasu wykonania wtyczki odrzuciły licencję | Przeczytaj komunikat wyjątku/odrzucenia bez ujawniania go nieufnym klientom |
| Licencja per-funkcjonalność działała wcześniej, ale nie teraz | Stary kod przekazywał explicite ścieżki licencji do konstruktora Viewer | Przenieś powiązane pliki .lic obok Doconut.Viewer.lic i pozwól automatycznemu wykrywaniu je załadować |
Następne kroki
- Licencjonowanie — możliwości, poziomy licencji i weryfikacja tego, co zostało załadowane w czasie działania.
- Rozwiązywanie problemów — znaki wodne, odrzucone licencje i błędy możliwości.
Czy ta strona była pomocna?