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
| Status | Membuka dokumen? | Tanda air | Kemampuan |
|---|---|---|---|
| Lisensi Penuh (berbayar) (build ini dirilis sebelum tanggal berlangganannya) | Ya | Tidak ada | Yang dibeli (Has* flags) |
| Lisensi Sementara (Developer/NFR — lisensi evaluasi, sebelum tanggal kedaluwarsanya) | Ya | Tidak ada pada penampil dasar; output plugin memiliki tanda air | Semua — pemberian menyeluruh (saluran evaluasi) |
Lisensi Sementara Kedaluwarsa (melewati tanggal LicenseExpiry) | Ya | Tanda air evaluasi | Tidak ada yang diberikan |
| Tidak ada berkas lisensi sama sekali | Ya | Tanda air evaluasi | Tidak 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 (dariOpenDocumentAsync) membawa alasan dariLicense.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:
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // lisensi non-TRIAL ada DAN mencakup versi build iniGerbang tunggal yang digunakan seluruh pipeline adalah IsCapabilityGranted:
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:
| Anggota | Arti |
|---|---|
IsTemporary | Tag ExpiryNote ada (deteksi dilakukan berdasarkan keberadaan tag — tidak pernah mencocokkan teks catatan, bersifat dinamis) |
ExpiryNote | Teks informasional yang tertanam dalam lisensi |
LicenseExpiry | Tanggal 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):
| Anggota | Arti |
|---|---|
License | Snapshot lengkap DoconutLicenseInfo (di bawah) |
IsTrial | Berkas tipe TRIAL warisan (diperlakukan sebagai tidak berlisensi — bukan hak) |
IsTemporary / ExpiryNote / LicenseExpiry | Penanda lisensi sementara |
IsExpired | Kedaluwarsa sesuai aturan tingkatan di atas |
IsVersionValid | Build ini berada dalam jendela dukungan lisensi |
IsViewerLicensed | Berkas non-TRIAL ditemukan dan versi tercakup — prasyarat dasar |
IsCapabilityGranted(cap) | Gerbang kemampuan tunggal |
HasSearch HasAnnotation HasEditor HasConverter HasDicom HasDocumentTools HasSigner HasRedactor HasComparer HasForms HasProtector HasCompressor | Satu 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 *.* |
LicenseRejectionReason | Tidak 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.
// 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:
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?