Licencjonowanie
Możliwości, poziomy licencji i usługa licencyjna
Ta strona jest odniesieniem w czasie wykonywania, jak licencja kształtuje zachowanie Doconut: co pozwala każdy stan licencji, jak przyznawane są możliwości i jak sprawdzić to wszystko w kodzie. (Aby wczytać licencję, zobacz Rozpoczęcie → Konfiguracja licencji.)
Stany licencji i ich działanie
| Stan | Otwiera dokumenty? | Znak wodny | Możliwości |
|---|---|---|---|
| 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; wyjście wtyczki jest oznaczone znakiem wodnym | 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, manipulacja, 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, z jej możliwościami — 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 wyświetlane są z znakiem wodnym i żadna możliwość (wyszukiwanie, adnotacje, wtyczki) nie jest aktywna. Pełne, nieoznaczone znakiem wodnym doświadczenie wymaga rzeczywistej Tymczasowej licencji (pobierz ją).
- 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 wykrywasz to przy wdrożeniu — a nie poprzez ciche dostarczanie wyjścia z znakiem wodnym. Ten wyjątek (zOpenDocumentAsync) zawiera przyczynę zLicense.RejectionMessage.
Możliwości
Doconut kontroluje opcjonalną funkcjonalność za pomocą możliwości. Obejmuje wbudowane funkcje Search i Annotation oraz opcjonalne wtyczki Converter, Dicom i Signer, każda przyznawana na podstawie twojej licencji. Podstawowy podgląd nie jest możliwością — jest wymogiem wstępnym, udostępnionym jako IsViewerLicensed:
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // licencja non-TRIAL obecna AND obejmująca wersję tego builduJedyną bramą, 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 możliwości — w tym te, które jeszcze nie mają dedykowanej flagi zakupu; rzeczywista zakupiona licencja przyznaje dokładnie swoje flagi Has* i jest domyślnie-odmawiająca dla wszystkiego, co nie jest zmapowane. (Plik typu TRIAL z dziedzictwa nie jest uprawnieniem — jest traktowany jako nielicencjonowany: oznaczony znakiem wodnym, nic nie przyznane.)
Tymczasowe licencje
Tymczasowe (Developer/NFR) licencje są oznaczone tagiem ExpiryNote i posiadają 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 daty 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 możliwości.
Odniesienie do IDoconutLicenseService
Wstrzyknij IDoconutLicenseService (przestrzeń nazw Doconut.Core.Interfaces; zarejestrowany jako singleton — licencja jest parsowana raz przy uruchomieniu):
| Członek | Znaczenie |
|---|---|
License | Pełna migawka DoconutLicenseInfo (poniżej) |
IsTrial | Plik typu TRIAL z dziedzictwa (traktowany jako nielicencjonowany — nie jest uprawnieniem) |
IsTemporary / ExpiryNote / LicenseExpiry | Znaczniki licencji tymczasowej |
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 wymóg wstępny |
IsCapabilityGranted(cap) | Jedyna brama możliwości |
HasSearch HasAnnotation HasEditor HasConverter HasDicom HasDocumentTools HasSigner HasRedactor HasComparer HasForms HasProtector HasCompressor | Jedna flaga na możliwość: zakupiona przez licencję obejmującą tę kompilację lub przyznana przez aktywną tymczasową licencję. IsCapabilityGranted odpowiada na to samo pytanie według możliwości |
IsValidForDomain(host) | Pokrycie hosta; licencje V4 używają wieloznacznika *.* |
LicenseRejectionReason | Niepusty ⇒ otwieranie jest blokowane tą wiadomością |
DoconutLicenseInfo udostępnia przyjazną dla wyświetlania migawkę dla paneli administracyjnych: Owner, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, flagi Has*, pola licencji tymczasowej oraz RejectionMessage.
// Feature-flag swó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 ją do swojego monitoringu, a wygasająca subskrypcja stanie się alarmem 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 (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 zrestartuj aplikację, aby AddDoconut() załadował nową licencję.
Czy ta strona była pomocna?