Lisanslama
Yetenekler, lisans katmanları 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. (Bir lisansı yüklemek için, Başlarken → Lisans Kurulumu bölümüne bakın.)
Lisans durumları ve ne yaptıkları
| Durum | Belge açar mı? | Filigran | Yetenekler |
|---|---|---|---|
| Tam (ücretli) lisans (bu yapı, abonelik tarihinden önce yayınlanmıştır) | Evet | Yok | Satın alınanlar (Has* bayrakları) |
| Geçici lisans (Geliştirici/NFR — değerlendirme lisansı, son tarihinden önce) | Evet | Temel görüntüleyicide yok; eklenti çıktısı filigranlı | Tümü — kapsamlı izin (değerlendirme hunisi) |
Süresi dolmuş geçici lisans (LicenseExpiry tarihinin geçmiş olduğu) | Evet | Değerlendirme filigranı | Hiçbiri verilmedi |
| Hiç lisans dosyası yok | Evet | Değerlendirme filigranı | Hiçbiri 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çmada | — | — |
Abonelik tarihi geçmiş bir ücretli lisans, o tarihten önce yayınlanan her yapı üzerinde temiz bir ş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ı olarak 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).
- Sadece 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 bir şekilde render etmeye devam eder; ancak lisansın abonelik tarihinden sonra yayınlanan bir yapı dağıtıldığında reddedilir ve bir
LicenseExceptionile hızlıca başarır, böylece dağıtımda yakalarsınız — sessizce filigranlı çıktı göndermek yerine. Bu istisna (OpenDocumentAsync'den) nedeniLicense.RejectionMessage'den taşır.
Yetenekler
Doconut, isteğe bağlı işlevselliği yetenek ile kısıtlar. Bu, 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:
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // non-TRIAL lisansı mevcut VE bu derlemenin sürümünü kapsıyorTüm işlem hattının kullandığı tek kapı IsCapabilityGranted:
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool searchGranted = lic.IsCapabilityGranted(LicenseCapability.Search);Mantığı, uygulamadan alıntı olarak: aktif (süresi dolmamış) Geçici lisans her yeteneği verir — henüz özel bir satın alma bayrağı olmayan yetenekler dahil; gerçek satın alınmış bir lisans tam olarak Has* bayraklarını verir ve eşleşmeyen her şey için varsayılan-red durumundadır. (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:
| Üye | Anlam |
|---|---|
IsTemporary | Bir ExpiryNote etiketi mevcut (algılama etiket varlığıyla yapılır — notun metniyle eşleşmez, dinamiktir) |
ExpiryNote | Lisansa gömülü bilgilendirici metin |
LicenseExpiry | Kesin son tarih (DateTime?) |
Son tarih anlamı katmana göre farklıdır: bir geçici lisans, sadece LicenseExpiry tarihi itibarıyla sona erer (abonelik penceresi göz ardı edilir; tarihi olmayan bir geçici lisans süresi dolmuş olarak kabul edilir, güvenli hata). 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):
| Üye | Anlam |
|---|---|
License | Tam DoconutLicenseInfo anlık görüntüsü (aşağıda) |
IsTrial | Eski bir TRIAL-tipi dosya (lisanssız olarak değerlendirilir — hak değildir) |
IsTemporary / ExpiryNote / LicenseExpiry | Geçici-lisans işaretçileri |
IsExpired | Yukarıdaki katman kurallarına göre süresi dolmuş |
IsVersionValid | Bu yapı, lisansın destek penceresi içinde yer alıyor |
IsViewerLicensed | Non-TRIAL dosya 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 HasCompressor | Yetenek başına bir bayrak: bu yapıyı kapsayan bir lisans tarafından satın alınmış veya aktif bir Geçici lisans tarafından verilmiş. IsCapabilityGranted aynı soruyu yetenek bazında yanıtlar |
IsValidForDomain(host) | Host kapsamı; V4 lisansları joker karakter *.* kullanır |
LicenseRejectionReason | Boş değil ⇒ açma bu mesajla engellenir |
DoconutLicenseInfo, yönetici panelleri için görüntü dostu anlık görüntüyü ortaya koyar: Owner, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, Has* bayrakları, geçici-lisans alanları ve RejectionMessage.
// Feature-flag UI'nizi SDK'nın kullandığı aynı gerçek kaynaktan
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ıyla lisans/süre sonu durumunu raporlayan bir "doconut" sağlık kontrolü kaydeder:
app.MapHealthChecks("/health");Bunu izleme sisteminize bağlayın ve süresi dolan bir abonelik, destek talebi yerine bir uyarı olur. 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 render etmeye 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'a dönüşür ve bir LicenseException ile açma engellenir (neden License.RejectionMessage'da bulunur) — kasıtlı olarak hızlı başarır, böylece eski veya lisanssız bir yapı dağıtımda yakalanır, sessizce üretim çıktısına filigran eklemek yerine. 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?