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 je wszystkie sprawdzić w kodzie. (Aby wczytać licencję, zobacz Rozpoczęcie → Konfiguracja licencji.)
Stany licencji i ich działanie
| Stan | Otwiera dokumenty? | Znak wodny | Funkcje |
|---|---|---|---|
| Pełna (płatna) licencja (ta kompilacja została wydana przed datą subskrypcji) | Tak | Brak | Te zakupione (Has* flagi) |
| Tymczasowa licencja (Developer/NFR — licencja ewaluacyjna, przed datą wygaśnięcia) | Tak | Brak w podstawowym przeglądarce; wynik wtyczki jest znakowany | 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, manipulowany, 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.
Dwa wnioski warte zapamiętania:
- Brak licencji nie jest licencją tymczasową. Bez pliku licencji strony są wyświetlane ze znakiem wodnym i żadna funkcja (wyszukiwanie, adnotacje, wtyczki) nie jest aktywna. Pełne, nieoznaczone znakiem wodnym doświadczenie wymaga rzeczywistej tymczasowej licencji (zdobądź jedną).
- Tylko odrzucona licencja blokuje otwieranie. Wygasła Tymczasowa licencja utrzymuje aplikację działającą ze 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 wykrywasz to przy wdrożeniu — a nie przez ciche dostarczanie znakowanego wyniku. 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 na podstawie twojej licencji. Podstawowy podgląd nie jest funkcją — jest warunkiem wstępnym, udostępnionym jako IsViewerLicensed:
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // licencja non-TRIAL jest obecna ORAZ obejmuje 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 te, które nie mają jeszcze dedykowanej flagi zakupu; prawdziwa zakupiona licencja przyznaje dokładnie swoje flagi Has* i ma domyślne odrzucenie dla wszystkiego, co nie jest zmapowane. (Plik typu TRIAL z dziedzictwa nie jest uprawnieniem — jest traktowany jako nielicencjonowany: znakowany, nic nie przyznane.)
Tymczasowe licencje
Tymczasowe licencje (Developer/NFR) 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 dopasowuje się tekstu notatki, jest dynamiczna) |
ExpiryNote | Informacyjny tekst wbudowany w licencję |
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łny migawkę DoconutLicenseInfo (poniżej) |
IsTrial | Plik typu TRIAL z dziedzictwa (traktowany jako nielicencjonowany — nie uprawnienie) |
IsTemporary / ExpiryNote / LicenseExpiry | Markery licencji tymczasowych |
IsExpired | Wygasła zgodnie z powyższymi regułami poziomu |
IsVersionValid | Ta kompilacja mieści się w oknie wsparcia licencji |
IsViewerLicensed | Znaleziono plik nie-TRIAL i wersja objęta — podstawowy warunek 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) | Pokrycie hosta; licencje V4 używają wieloznacznego *.* |
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 twoje 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,
}));Sprawdzenie stanu zdrowia
AddDoconut() rejestruje "doconut" sprawdzenie stanu zdrowia, które 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. Sprawdzenie 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 się na false i otwieranie jest blokowane za pomocą LicenseException (powód znajduje się w License.RejectionMessage) — celowo szybkie niepowodzenie, 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() wczytała nową licencję.
Czy ta strona była pomocna?