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

StanOtwiera dokumenty?Znak wodnyMożliwości
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; wyjście wtyczki jest oznaczone znakiem wodnymWszystkie — 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, 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 (z OpenDocumentAsync) zawiera przyczynę z License.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:

csharp
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // licencja non-TRIAL obecna AND obejmująca wersję tego buildu

Jedyną bramą, 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 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:

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 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łonekZnaczenie
LicensePełna migawka DoconutLicenseInfo (poniżej)
IsTrialPlik typu TRIAL z dziedzictwa (traktowany jako nielicencjonowany — nie jest uprawnieniem)
IsTemporary / ExpiryNote / LicenseExpiryZnaczniki licencji tymczasowej
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 wymóg wstępny
IsCapabilityGranted(cap)Jedyna brama możliwości
HasSearch HasAnnotation HasEditor HasConverter HasDicom HasDocumentTools HasSigner HasRedactor HasComparer HasForms HasProtector HasCompressorJedna 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 *.*
LicenseRejectionReasonNiepusty ⇒ 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.

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

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