Lisensi

Kemampuan, tingkatan lisensi, dan layanan lisensi

Halaman ini adalah referensi runtime tentang bagaimana lisensi membentuk perilaku Doconut: apa yang diizinkan oleh setiap status lisensi, bagaimana kemampuan diberikan, dan cara memeriksa semuanya dari kode. (Untuk memuat lisensi, lihat Memulai → Penyiapan Lisensi.)

Status Lisensi dan Apa yang Dilakukannya

StatusMembuka dokumen?Tanda airKemampuan
Lisensi Penuh (berbayar) (build ini dirilis sebelum tanggal berlangganannya)YaTidak adaYang dibeli (Has* flags)
Lisensi Sementara (Developer/NFR — lisensi evaluasi, sebelum tanggal kedaluwarsanya)YaTidak ada pada penampil dasar; output plugin memiliki tanda airSemua — pemberian menyeluruh (saluran evaluasi)
Lisensi Sementara Kedaluwarsa (melewati tanggal LicenseExpiry)YaTanda air evaluasiTidak ada yang diberikan
Tidak ada berkas lisensi sama sekaliYaTanda air evaluasiTidak ada yang diberikan
Ditemukan tetapi ditolak (tanda tangan tidak valid, diubah, diblokir, atau build dirilis setelah tanggal berlangganan lisensi)Tidak — LicenseException pada setiap pembukaan——

Lisensi berbayar yang tanggal berlangganannya telah lewat tetap berfungsi — bersih, dengan kemampuannya — pada setiap build yang dirilis sebelum tanggal tersebut. Hanya build yang dirilis setelahnya yang ditolak.

Dua konsekuensi yang penting dipahami:

  • Lisensi yang hilang bukan lisensi sementara. Tanpa berkas lisensi, halaman ditampilkan dengan tanda air dan tidak ada kemampuan (pencarian, anotasi, plugin) yang aktif. Pengalaman lengkap tanpa tanda air memerlukan Lisensi Sementara yang sebenarnya (dapatkan satu).
  • Hanya lisensi yang ditolak yang memblokir pembukaan. Lisensi Sementara yang kedaluwarsa membuat aplikasi tetap berjalan dengan tanda air evaluasi, dan lisensi berbayar yang melewati tanggal berlangganannya tetap menampilkan bersih pada build yang dicakup; tetapi menyebarkan build yang dirilis setelah tanggal berlangganan lisensi akan ditolak dan gagal cepat dengan LicenseException, sehingga Anda menanganinya saat penyebaran — bukan dengan diam‑diam mengirim output bertanda air. Pengecualian itu (dari OpenDocumentAsync) membawa alasan dari License.RejectionMessage.

Kemampuan

Doconut mengatur fungsionalitas opsional dengan kemampuan. Ini mencakup fitur bawaan Search dan Annotation serta plugin Converter, Dicom, dan Signer yang dapat dipilih, masing‑masing diberikan oleh lisensi Anda. Penampil dasar bukanlah sebuah kemampuan — ia adalah prasyarat, ditampilkan sebagai IsViewerLicensed:

csharp
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // lisensi non-TRIAL ada DAN mencakup versi build ini

Gerbang tunggal yang digunakan seluruh pipeline adalah IsCapabilityGranted:

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

Logikanya, persis dari implementasi: lisensi Sementara yang aktif (tidak kedaluwarsa) memberikan setiap kemampuan — termasuk kemampuan yang belum memiliki flag pembelian khusus; lisensi berbayar yang sebenarnya memberikan tepat flag Has*‑nya dan bersifat default-deny untuk apa pun yang tidak dipetakan. (Berkas tipe TRIAL warisan bukan hak — diperlakukan sebagai tidak berlisensi: bertanda air, tidak ada yang diberikan.)

Lisensi Sementara

Lisensi (Developer/NFR) Sementara ditandai dengan tag ExpiryNote dan memiliki tanggal kedaluwarsa yang keras:

AnggotaArti
IsTemporaryTag ExpiryNote ada (deteksi dilakukan berdasarkan keberadaan tag — tidak pernah mencocokkan teks catatan, bersifat dinamis)
ExpiryNoteTeks informasional yang tertanam dalam lisensi
LicenseExpiryTanggal kedaluwarsa keras (DateTime?)

Semantik kedaluwarsa berbeda menurut tingkatan: lisensi sementara kedaluwarsa pada tanggal LicenseExpiry saja (jendela berlangganannya diabaikan; lisensi sementara yang tidak memiliki tanggal diperlakukan sebagai kedaluwarsa, aman). Semua lisensi lain kedaluwarsa pada tanggal jendela berlangganan/pembaruan; untuk lisensi berbayar, IsExpired hanya melaporkan bahwa tanggal tersebut telah lewat — build yang dirilis sebelum tanggal itu tetap bersih dan mempertahankan kemampuannya.

Referensi IDoconutLicenseService

Suntikkan IDoconutLicenseService (namespace Doconut.Core.Interfaces; terdaftar sebagai singleton — lisensi diparsing sekali saat startup):

AnggotaArti
LicenseSnapshot lengkap DoconutLicenseInfo (di bawah)
IsTrialBerkas tipe TRIAL warisan (diperlakukan sebagai tidak berlisensi — bukan hak)
IsTemporary / ExpiryNote / LicenseExpiryPenanda lisensi sementara
IsExpiredKedaluwarsa sesuai aturan tingkatan di atas
IsVersionValidBuild ini berada dalam jendela dukungan lisensi
IsViewerLicensedBerkas non-TRIAL ditemukan dan versi tercakup — prasyarat dasar
IsCapabilityGranted(cap)Gerbang kemampuan tunggal
HasSearch HasAnnotation HasEditor HasConverter HasDicom HasDocumentTools HasSigner HasRedactor HasComparer HasForms HasProtector HasCompressorSatu flag per kemampuan: dibeli oleh lisensi yang mencakup build ini, atau diberikan oleh lisensi Sementara yang aktif. IsCapabilityGranted menjawab pertanyaan yang sama per kemampuan
IsValidForDomain(host)Cakupan host; lisensi V4 menggunakan wildcard *.*
LicenseRejectionReasonTidak kosong ⇒ pembukaan diblokir dengan pesan ini

DoconutLicenseInfo menampilkan snapshot yang ramah tampilan untuk panel admin: Owner, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, flag Has*, bidang lisensi sementara, dan RejectionMessage.

csharp
// Feature-flag UI Anda dari sumber kebenaran yang sama yang digunakan 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,
}));

Pemeriksaan Kesehatan

AddDoconut() mendaftarkan pemeriksaan kesehatan "doconut" yang melaporkan status lisensi/kedaluwarsa melalui mekanisme standar ASP.NET Core:

csharp
app.MapHealthChecks("/health");

Hubungkan ke sistem pemantauan Anda dan langganan yang akan kedaluwarsa menjadi peringatan alih‑alih tiket dukungan. Pemeriksaan melaporkan Unhealthy ketika lisensi ditolak atau IsExpired bernilai true; untuk lisensi berbayar, itu berarti tanggal berlangganan telah lewat dan paket yang dirilis setelahnya akan ditolak — build saat ini tetap menampilkan bersih.

Pembaruan Versi

Lisensi mencakup jendela versi. Memperbarui paket NuGet ke build lebih baru dari jendela tersebut membuat lisensi tidak valid untuk build ini: IsVersionValid mengubah false dan pembukaan diblokir dengan LicenseException (alasan ada di License.RejectionMessage) — sengaja gagal cepat, sehingga build usang atau tidak berlisensi terdeteksi saat penyebaran alih‑alih secara diam‑diam menandai air output produksi. Perbarui langganan, ganti .lic, dan restart aplikasi sehingga AddDoconut() memuat lisensi baru.

Apakah halaman ini membantu?