Lisanslama

Yetenekler, lisans seviyeleri ve lisans hizmeti

Bu sayfa, bir lisansın Doconut'un davranışını nasıl şekillendirdiğine dair çalışma zamanı referansıdır: her lisans durumunun neye izin verdiği, yeteneklerin nasıl verildiği ve bunların tümünün koddan nasıl inceleneceği. (Yükleme için, Başlarken → Lisans Kurulumu bölümüne bakın.)

Lisans durumları ve ne yaptıkları

DurumBelge açar mı?FiligranYetenekler
Tam (ücretli) lisans (bu yapı, abonelik tarihinden önce yayınlandı)EvetYokSatın alınanlar (Has* bayrakları)
Geçici lisans (Geliştirici/NFR — değerlendirme lisansı, son tarihinden önce)EvetTemel görüntüleyicide yok; eklenti çıktısı filigranlıTümü — genel izin (değerlendirme hunisi)
Süresi dolmuş geçici lisans (LicenseExpiry tarihinin geçmiş olması)EvetDeğerlendirme filigranıHiçbir şey verilmedi
Hiç lisans dosyası yokEvetDeğerlendirme filigranıHiçbir şey verilmedi
Bulundu ancak reddedildi (geçersiz imza, değiştirilmiş, kara listeye alınmış veya lisansın abonelik tarihinden sonra yayınlanan bir yapı)Hayır — LicenseException her açışta——

Abonelik tarihi geçmiş bir ücretli lisans, o tarihten önce yayınlanan her yapı üzerinde temiz şekilde, yetenekleriyle birlikte çalışmaya devam eder. Sadece ondan sonra yayınlanan bir yapı reddedilir.

İçselleştirmeniz gereken iki sonuç:

  • Eksik bir lisans geçici bir lisans değildir. Lisans dosyası olmadığında, sayfalar filigranlı görüntülenir ve hiçbir yetenek (arama, açıklama, eklentiler) aktif değildir. Tam özellikli, filigransız deneyim gerçek bir Geçici lisans gerektirir (bir tane edinin).
  • Yalnızca reddedilen bir lisans açmayı engeller. Süresi dolmuş bir Geçici lisans, uygulamayı değerlendirme filigranı ile çalışır durumda tutar ve abonelik tarihini geçmiş bir ücretli lisans, kapsadığı yapılar üzerinde temiz şekilde görüntülenmeye devam eder; ancak lisansın abonelik tarihinden sonra yayınlanan bir yapı dağıtıldığında reddedilir ve hızlı bir şekilde başarısız olur bir LicenseException ile, böylece dağıtımda yakalarsınız — sessizce filigranlı çıktı göndererek değil. Bu istisna (OpenDocumentAsync'den) License.RejectionMessage'den nedeni taşır.

Yetenekler

Doconut, isteğe bağlı işlevselliği yetenek ile sınırlar. Yerleşik Arama ve Açıklama özelliklerini ve isteğe bağlı Dönüştürücü, Dicom ve İmzalayıcı eklentilerini kapsar; her biri lisansınız tarafından verilir. Temel görüntüleyici bir yetenek değildir — önkoşuldur ve IsViewerLicensed olarak ortaya çıkar:

csharp
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // non-TRIAL lisans mevcut AND bu derlemenin sürümünü kapsayan

Tüm işlem hattının kullandığı tek kapı IsCapabilityGranted:

csharp
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool searchGranted = lic.IsCapabilityGranted(LicenseCapability.Search);

Mantığı, uygulamadan alıntı olarak: aktif (süresi dolmamış) Geçici lisans tüm yetenekleri verir — henüz özel bir satın alma bayrağı olmayan yetenekler dahil; gerçek bir satın alınmış lisans tam olarak Has* bayraklarını verir ve eşlenmemiş her şey için varsayılan-red. (Eski bir TRIAL-tipi dosya hak değildir — lisanssız olarak değerlendirilir: filigranlı, hiçbir şey verilmez.)

Geçici lisanslar

Geçici (Geliştirici/NFR) lisanslar, bir ExpiryNote etiketiyle işaretlenir ve kesin bir son tarih taşır:

ÜyeAnlam
IsTemporaryBir ExpiryNote etiketi mevcut (algılama etiket varlığıyla yapılır — notun metniyle eşleşmez, dinamiktir)
ExpiryNoteLisansa gömülü bilgilendirme metni
LicenseExpiryKesin son tarih (DateTime?)

Son tarih anlamı katmana göre farklıdır: bir geçici lisans, sadece LicenseExpiry tarihi üzerine sona erer (abonelik penceresi yok sayılır; tarihi olmayan bir geçici lisans süresi dolmuş olarak kabul edilir, güvenli durum). Diğer tüm lisanslar abonelik/güncelleme penceresi tarihine göre sona erer; ücretli bir lisans için, IsExpired yalnızca bu tarihin geçtiğini rapor eder — ondan önce yayınlanan yapılar temiz kalır ve yeteneklerini korur.

IDoconutLicenseService referansı

IDoconutLicenseService enjekte edin (namespace Doconut.Core.Interfaces; singleton olarak kaydedilir — lisans başlangıçta bir kez ayrıştırılır):

ÜyeAnlam
LicenseTam DoconutLicenseInfo anlık görüntüsü (aşağıda)
IsTrialEski bir TRIAL-tipi dosya (lisanssız olarak değerlendirilir — hak değildir)
IsTemporary / ExpiryNote / LicenseExpiryGeçici-lisans işaretçileri
IsExpiredYukarıdaki katman kurallarına göre süresi dolmuş
IsVersionValidBu yapı, lisansın destek penceresi içinde yer alıyor
IsViewerLicensedNon-TRIAL dosyası bulundu ve sürüm kapsandı — temel önkoşul
IsCapabilityGranted(cap)Tek yetenek kapısı
HasSearch HasAnnotation HasEditor HasConverter HasDicom HasDocumentTools HasSigner HasRedactor HasComparer HasForms HasProtector HasCompressorHer yetenek için bir bayrak: bu yapıyı kapsayan bir lisans tarafından satın alınan veya aktif bir Geçici lisans tarafından verilen. IsCapabilityGranted aynı soruyu yetenek bazında yanıtlar
IsValidForDomain(host)Host kapsamı; V4 lisansları joker karakter *.* kullanır
LicenseRejectionReasonBoş değil ⇒ açma bu mesajla engellenir

DoconutLicenseInfo, yönetim panelleri için görüntü dostu anlık görüntüyü ortaya çıkarır: Owner, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, Has* bayrakları, geçici-lisans alanları ve RejectionMessage.

csharp
// Feature-flag UI'nizi SDK'nin kullandığı aynı gerçek kaynağından
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,
}));

Sağlık kontrolü

AddDoconut(), standart ASP.NET Core mekanizması üzerinden lisans/süre dolma durumunu raporlayan bir "doconut" sağlık kontrolü kaydeder:

csharp
app.MapHealthChecks("/health");

Bunu izleme sisteminize bağlayın ve süresi dolan bir abonelik, destek talebi yerine bir uyarı haline gelir. Kontrol, lisans reddedildiğinde veya IsExpired doğru olduğunda Unhealthy rapor eder; ücretli bir lisans için bu, abonelik tarihinin geçtiği ve ondan sonra yayınlanan bir paketin reddedileceği anlamına gelir — mevcut yapı temiz görüntülenmeye devam eder.

Sürüm yükseltmeleri

Bir lisans bir sürüm penceresini kapsar. NuGet paketini bu pencerenin daha yeni bir yapısına güncellemek, lisansı bu yapı için geçersiz kılar: IsVersionValid, false'e dönüşür ve açma, bir LicenseException ile engellenir (neden License.RejectionMessage'de bulunur) — kasıtlı olarak hızlı başarısızlık, böylece eski veya lisanssız bir yapı dağıtımda yakalanır, üretim çıktısını sessizce filigranlamaz. Aboneliği yenileyin, .lic'ı değiştirin ve uygulamayı yeniden başlatın, böylece AddDoconut() yeni lisansı yükler.

Bu sayfa yardımcı oldu mu?