Licencjonowanie

Funkcje, poziomy licencji i usługa licencji

Ta strona jest odniesieniem w czasie działania, opisującym, jak licencja kształtuje zachowanie Doconut: co pozwala każdy stan licencji, jak przyznawane są funkcje i jak sprawdzić to wszystko z kodu. (Aby wczytać licencję, zobacz 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; 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, 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 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ź ją).
  • Tylko odrzucona licencja blokuje otwieranie. Wygasła Tymczasowa licencja utrzymuje aplikację w działaniu ze znakiem wodnym ewaluacji, a płatna licencja po dacie subskrypcji pozostaje czysta 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 wyjścia ze znakiem wodnym. Ten wyjątek (z OpenDocumentAsync) zawiera powód z License.RejectionMessage.

Funkcje

Doconut ogranicza opcjonalną funkcjonalność za pomocą funkcji. Obejmuje wbudowane funkcje Wyszukiwanie i Adnotacje oraz opcjonalne wtyczki Konwerter, Dicom i Signer, każda przyznawana na podstawie twojej licencji. Podstawowy podgląd nie jest funkcją — jest warunkiem wstępnym, udostępnionym jako IsViewerLicensed:

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

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

csharp
var lic = Doconut.DoconutHost.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; rzeczywista zakupiona licencja przyznaje dokładnie swoje flagi Has* i ma domyślne odrzucenie dla wszystkiego, co nie jest zmapowane. (Plik typu TRIAL z przeszłości 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:

CzłonekZnaczenie
IsTemporaryTag ExpiryNote jest obecny (detekcja odbywa się na podstawie obecności tagu — nigdy nie dopasowuje się do tekstu notatki, jest dynamiczna)
ExpiryNoteTekst informacyjny 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.

IDoconutLicenseService referencja

Rozwiąż IDoconutLicenseService (przestrzeń nazw Doconut.Core.Interfaces) z DoconutHost.Services. Jest to singleton — licencja jest parsowana raz, w DoconutHost.Initialize:

CzłonekZnaczenie
LicensePełna migawka DoconutLicenseInfo (poniżej)
IsTrialPlik typu TRIAL w wersji legacy (traktowany jako nielicencjonowany — nie jest uprawnieniem)
IsTemporary / ExpiryNote / LicenseExpiryZnaczniki tymczasowej licencji
IsExpiredWygasło zgodnie z powyższymi zasadami poziomu
IsVersionValidTa wersja mieści się w oknie wsparcia licencji
IsViewerLicensedZnaleziono plik nie-TRIAL i wersja objęta — podstawowy warunek wstępny
IsCapabilityGranted(cap)Jedyna bramka 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ę wersję, 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 z tym komunikatem

DoconutLicenseInfo udostępnia przyjazną dla wyświetlania migawkę dla paneli administracyjnych: Owner, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, flagi Has*, pola tymczasowej licencji oraz RejectionMessage.

csharp
// GET /Features - ustaw flagę funkcji w UI z tego samego źródła prawdy, którego używa SDK
public ActionResult Index()
{
    var lic = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();

    return Json(new
    {
        viewer     = lic.IsViewerLicensed || lic.IsTemporary,
        search     = lic.IsCapabilityGranted(LicenseCapability.Search),
        annotation = lic.IsCapabilityGranted(LicenseCapability.Annotation),
        conversion = lic.HasConverter,
        dicom      = lic.HasDicom,
    }, JsonRequestBehavior.AllowGet);
}

Sprawdzenie stanu

Doconut rejestruje "doconut" sprawdzenie stanu, które raportuje stan licencji. Classic ASP.NET nie posiada własnego punktu końcowego stanu, więc udostępnij je z kontrolera:

csharp
// GET /Health - Doconut rejestruje kontrolę stanu zdrowia "doconut", która raportuje stan licencji:
// Zdrowy (prawidłowy), Obniżony (wersja próbna lub brak pliku licencji), Niezdrowy (odrzucona lub wygasła).
public async Task<ActionResult> Index()
{
    var health = Doconut.DoconutHost.Services.GetRequiredService<HealthCheckService>();
    HealthReport report = await health.CheckHealthAsync();

    Response.StatusCode = report.Status == HealthStatus.Unhealthy ? 503 : 200;
    return Content(report.Status.ToString(), "text/plain");
}

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 wersja pozostaje czysta. Zobacz DoconutHost po wartości statusu.

Uaktualnienia wersji

Licencja obejmuje okno wersji. Aktualizacja pakietu NuGet do wersji nowszej niż to okno powoduje, że licencja jest nieważna dla tej wersji: IsVersionValid zmienia false i otwieranie jest blokowane przy użyciu LicenseException (powód znajduje się w License.RejectionMessage) — celowo szybka awaria, aby przestarzała lub nielicencjonowana wersja została wykryta przy wdrożeniu, a nie cicho znakowana w produkcji. Odnów subskrypcję, zamień .lic w wwwroot i zresetuj pulę aplikacji, aby DoconutHost.Initialize załadował nową licencję.

Czy ta strona była pomocna?