Licencjonowanie
Funkcje, poziomy licencji i usługa licencji
Ta strona jest odniesieniem w czasie wykonywania, jak licencja kształtuje zachowanie Doconut: co pozwala każdy stan licencji, jak przyznawane są funkcje i jak sprawdzić to wszystko w kodzie. (Aby załadować licencję, zobacz Rozpoczęcie → Konfiguracja licencji.)
Stany licencji i co robią
| Stan | Otwiera dokumenty? | Znak wodny | Funkcje |
|---|---|---|---|
| Pełna (płatna) licencja (ta kompilacja została wydana przed datą subskrypcji) | Tak | Brak | Te zakupione (flagi Has*) |
| Tymczasowa licencja (Developer/NFR — licencja ewaluacyjna, przed datą wygaśnięcia) | Tak | Brak w podstawowym podglądzie; wyjście wtyczki jest znakowane | Wszystkie — pełne przyznanie (kanał ewaluacji) |
Wygasła tymczasowa licencja (po dacie LicenseExpiry) | Tak | Znak wodny ewaluacji | Brak przyznanych |
| Brak pliku licencji | Tak | Znak wodny ewaluacji | Brak przyznanych |
| Znaleziono, ale odrzucono (nieprawidłowy podpis, zmodyfikowany, na czarnej liście lub kompilacja wydana po dacie subskrypcji licencji) | Nie — LicenseException przy każdym otwarciu | — | — |
Płatna licencja, której data subskrypcji minęła, nadal działa — czysto, ze swoimi funkcjami — na każdej kompilacji wydanej przed tą datą. Tylko kompilacja wydana po tej dacie jest odrzucana.
Dwie konsekwencje warte zapamiętania:
- Brak licencji nie jest licencją tymczasową. Bez pliku licencji strony są wyświetlane z znakiem wodnym i żadna funkcja (wyszukiwanie, adnotacje, wtyczki) nie jest aktywna. Pełne, nieoznaczone znakiem wodnym doświadczenie wymaga rzeczywistej Tymczasowej licencji (pobierz jedną).
- Tylko odrzucona licencja blokuje otwieranie. Wygasła tymczasowa licencja utrzymuje aplikację w działaniu z znakiem wodnym ewaluacji, a płatna licencja po dacie subskrypcji nadal renderuje czysto na kompilacjach, które obejmuje; jednak wdrożenie kompilacji wydanej po dacie subskrypcji licencji jest odrzucane i szybko kończy się niepowodzeniem z
LicenseException, więc łapiesz to przy wdrożeniu — a nie cicho wysyłając znakowany wynik. Ten wyjątek (zOpenDocumentAsync) zawiera przyczynę zLicense.RejectionMessage.
Funkcje
Doconut kontroluje opcjonalną funkcjonalność za pomocą funkcji. Obejmuje wbudowane funkcje Search i Annotation oraz wtyczki Converter, Dicom i Signer, które są przyznawane przez twoją licencję. Podstawowy podgląd nie jest funkcją — jest wymogiem wstępnym, udostępnionym jako IsViewerLicensed:
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // non-TRIAL licencja obecna AND obejmująca wersję tego builduJedyną bramką, której używa cały potok, jest IsCapabilityGranted:
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool searchGranted = lic.IsCapabilityGranted(LicenseCapability.Search);Jej logika, dosłownie z implementacji: aktywna (nieprzeterminowana) Tymczasowa licencja przyznaje wszystkie funkcje — w tym funkcje, które jeszcze nie mają dedykowanej flagi zakupu; prawdziwa zakupiona licencja przyznaje dokładnie swoje flagi Has* i jest domyślnie-odrzucająca wszystko, co nie jest zmapowane. (Plik typu TRIAL z dziedzictwa nie jest uprawnieniem — jest traktowany jako nielicencjonowany: znakowany, nic nie przyznane.)
Tymczasowe licencje
Tymczasowe (Developer/NFR) licencje są oznaczone tagiem ExpiryNote i mają sztywną datę wygaśnięcia:
| Element | Znaczenie |
|---|---|
IsTemporary | Tag ExpiryNote jest obecny (detekcja odbywa się na podstawie obecności tagu — nigdy nie dopasowuj tekstu notatki, jest dynamiczna) |
ExpiryNote | Informacyjny tekst osadzony w licencji |
LicenseExpiry | Sztywna data wygaśnięcia (DateTime?) |
Semantyka wygaśnięcia różni się w zależności od poziomu: tymczasowa licencja wygasa w dniu LicenseExpiry tylko daty (okno subskrypcji jest ignorowane; tymczasowa licencja bez daty jest traktowana jako wygasła, zabezpieczenie). Wszystkie inne licencje wygasają w dniu subskrypcji/okna aktualizacji; w przypadku płatnej licencji, IsExpired jedynie informuje, że ta data minęła — kompilacje wydane przed nią pozostają czyste i zachowują swoje funkcje.
Odniesienie do IDoconutLicenseService
Wstrzyknij IDoconutLicenseService (przestrzeń nazw Doconut.Core.Interfaces; zarejestrowany jako singleton — licencja jest parsowana raz przy uruchomieniu):
| Element | Znaczenie |
|---|---|
License | Pełna migawka DoconutLicenseInfo (poniżej) |
IsTrial | Plik typu TRIAL z dziedzictwa (traktowany jako nielicencjonowany — nie jest uprawnieniem) |
IsTemporary / ExpiryNote / LicenseExpiry | Markery licencji tymczasowych |
IsExpired | Wygasła zgodnie z powyższymi zasadami poziomu |
IsVersionValid | Ta kompilacja mieści się w oknie wsparcia licencji |
IsViewerLicensed | Znaleziono plik nie-TRIAL i wersja objęta — podstawowy wymóg wstępny |
IsCapabilityGranted(cap) | Jedyna bramka funkcji |
HasSearch HasAnnotation HasEditor HasConverter HasDicom HasDocumentTools HasSigner HasRedactor HasComparer HasForms HasProtector HasCompressor | Jedna flaga na funkcję: zakupiona przez licencję obejmującą tę kompilację lub przyznana przez aktywną tymczasową licencję. IsCapabilityGranted odpowiada na to samo pytanie według funkcji |
IsValidForDomain(host) | Zasięg hosta; licencje V4 używają wieloznacznika *.* |
LicenseRejectionReason | Niepusty ⇒ otwieranie jest blokowane tym komunikatem |
DoconutLicenseInfo udostępnia przyjazną dla wyświetlania migawkę dla paneli administracyjnych: Owner, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, flagi Has*, pola licencji tymczasowych oraz RejectionMessage.
// Feature-flag twój UI z tego samego źródła prawdy, którego używa 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,
}));Kontrola zdrowia
AddDoconut() rejestruje kontrolę zdrowia "doconut", która raportuje stan licencji/wygaśnięcia poprzez standardowy mechanizm ASP.NET Core:
app.MapHealthChecks("/health");Podłącz to do swojego monitoringu, a wygasająca subskrypcja stanie się alertem zamiast zgłoszenia wsparcia. Kontrola raportuje Unhealthy, gdy licencja jest odrzucona lub IsExpired jest prawdziwe; w przypadku płatnej licencji oznacza to, że data subskrypcji minęła i pakiet wydany po niej zostanie odrzucony — bieżąca kompilacja nadal renderuje czysto.
Aktualizacje wersji
Licencja obejmuje okno wersji. Aktualizacja pakietu NuGet do kompilacji nowszej niż to okno powoduje, że licencja jest nieważna dla tej kompilacji: IsVersionValid zmienia false i otwieranie jest blokowane przy użyciu LicenseException (przyczyna znajduje się w License.RejectionMessage) — celowo szybkie zakończenie, aby przestarzała lub nielicencjonowana kompilacja została wykryta przy wdrożeniu, a nie cicho znakowana w produkcji. Odnów subskrypcję, wymień .lic i uruchom ponownie aplikację, aby AddDoconut() załadował nową licencję.
Czy ta strona była pomocna?