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ą

StanOtwiera dokumenty?Znak wodnyFunkcje
Pełna (płatna) licencja (ta kompilacja została wydana przed datą subskrypcji)TakBrakTe zakupione (flagi Has*)
Tymczasowa licencja (Developer/NFR — licencja ewaluacyjna, przed datą wygaśnięcia)TakBrak w podstawowym podglądzie; wyjście wtyczki jest znakowaneWszystkie — 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, 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 (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 przez twoją licencję. Podstawowy podgląd nie jest funkcją — jest wymogiem wstępnym, udostępnionym jako IsViewerLicensed:

csharp
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // non-TRIAL licencja obecna AND obejmująca 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 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:

ElementZnaczenie
IsTemporaryTag ExpiryNote jest obecny (detekcja odbywa się na podstawie obecności tagu — nigdy nie dopasowuj tekstu notatki, jest dynamiczna)
ExpiryNoteInformacyjny tekst osadzony w licencji
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łna migawka DoconutLicenseInfo (poniżej)
IsTrialPlik typu TRIAL z dziedzictwa (traktowany jako nielicencjonowany — nie jest uprawnieniem)
IsTemporary / ExpiryNote / LicenseExpiryMarkery licencji tymczasowych
IsExpiredWygasła zgodnie z powyższymi zasadami poziomu
IsVersionValidTa kompilacja mieści się w oknie wsparcia licencji
IsViewerLicensedZnaleziono 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 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)Zasięg hosta; licencje V4 używają wieloznacznika *.*
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 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:

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