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

StanOtwiera dokumenty?Znak wodnyFunkcje
Pełna (płatna) licencja (ta kompilacja została wydana przed datą subskrypcji)TakBrakTe zakupione (Has* flagi)
Tymczasowa licencja (Developer/NFR — licencja ewaluacyjna, przed datą wygaśnięcia)TakBrak w podstawowym przeglądarce; wynik wtyczki jest znakowanyWszystkie — pełne przyznanie (kanał ewaluacji)
Wygasła tymczasowa licencja (po dacie LicenseExpiry)TakZnak wodny ewaluacjiBrak przyznanych
Brak pliku licencjiTakZnak wodny ewaluacjiBrak 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 (z OpenDocumentAsync) zawiera przyczynę z License.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:

csharp
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // licencja non-TRIAL jest obecna ORAZ obejmuje wersję tego buildu

Jedyną bramką, której używa cały potok, jest IsCapabilityGranted:

csharp
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:

ElementZnaczenie
IsTemporaryTag ExpiryNote jest obecny (detekcja odbywa się na podstawie obecności tagu — nigdy nie dopasowuje się tekstu notatki, jest dynamiczna)
ExpiryNoteInformacyjny tekst wbudowany w licencję
LicenseExpirySztywna 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):

ElementZnaczenie
LicensePełny migawkę DoconutLicenseInfo (poniżej)
IsTrialPlik typu TRIAL z dziedzictwa (traktowany jako nielicencjonowany — nie uprawnienie)
IsTemporary / ExpiryNote / LicenseExpiryMarkery licencji tymczasowych
IsExpiredWygasła zgodnie z powyższymi regułami poziomu
IsVersionValidTa kompilacja mieści się w oknie wsparcia licencji
IsViewerLicensedZnaleziono 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 HasCompressorJedna 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 *.*
LicenseRejectionReasonNiepusty ⇒ 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.

csharp
// 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:

csharp
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?