Lisensi
Kemampuan, tingkatan lisensi, dan layanan lisensi
Halaman ini adalah referensi runtime tentang bagaimana sebuah lisensi membentuk perilaku Doconut: apa yang diizinkan oleh setiap status lisensi, bagaimana kemampuan diberikan, dan cara memeriksa semuanya dari kode. (Untuk memuat sebuah lisensi, lihat Pengaturan Lisensi.)
Status lisensi dan apa yang mereka lakukan
| Status | Membuka dokumen? | Watermark | Kemampuan |
|---|---|---|---|
| Lisensi penuh (berbayar) (build ini dirilis sebelum tanggal berlangganannya) | Ya | Tidak ada | Yang dibeli (Has* flags) |
| Lisensi sementara (Pengembang/NFR — lisensi evaluasi, sebelum tanggal kedaluwarsanya) | Ya | Tidak ada pada penampil dasar; output plugin diberi watermark | Semua — pemberian menyeluruh (saluran evaluasi) |
Lisensi sementara kedaluwarsa (melewati tanggal LicenseExpiry) | Ya | Watermark evaluasi | Tidak ada yang diberikan |
| Tidak ada berkas lisensi sama sekali | Ya | Watermark evaluasi | Tidak ada yang diberikan |
| Ditemukan tetapi ditolak (tanda tangan tidak valid, diubah, masuk daftar hitam, 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 watermark dan tidak ada kemampuan (pencarian, anotasi, plugin) yang aktif. Pengalaman lengkap tanpa watermark memerlukan Lisensi Sementara yang sebenarnya (dapatkan satu).
- Hanya lisensi yang ditolak yang memblokir pembukaan. Lisensi Sementara yang kedaluwarsa membuat aplikasi tetap berjalan dengan watermark evaluasi, dan lisensi berbayar yang melewati tanggal berlangganannya tetap menampilkan bersih pada build yang dicakup; tetapi menyebarkan build yang dirilis setelah tanggal berlangganan lisensi ditolak dan gagal cepat dengan
LicenseException, sehingga Anda menanganinya saat penyebaran — bukan dengan diam-diam mengirim output berwatermark. Pengecualian itu (dariOpenDocumentAsync) membawa alasan dariLicense.RejectionMessage.
Kemampuan
Doconut mengatur fungsionalitas opsional dengan kemampuan. Ini mencakup fitur Pencarian dan Anotasi bawaan serta plugin Konverter, Dicom, dan Penandatangan yang dapat dipilih, masing‑masing diberikan oleh lisensi Anda. Penampil dasar bukanlah sebuah kemampuan — itu adalah prasyarat, ditampilkan sebagai IsViewerLicensed:
var lic = Doconut.DoconutHost.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 = Doconut.DoconutHost.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: berwatermark, tidak ada yang diberikan.)
Lisensi Sementara
Lisensi sementara (Pengembang/NFR) 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.
IDoconutLicenseService referensi
Temukan IDoconutLicenseService (namespace Doconut.Core.Interfaces) dari DoconutHost.Services. Ini adalah singleton — lisensi diparsing sekali, di DoconutHost.Initialize:
| Anggota | Makna |
|---|---|
License | Snapshot lengkap DoconutLicenseInfo (di bawah) |
IsTrial | File tipe TRIAL legacy (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 | File 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.
// GET /Features - feature-flag UI Anda dari sumber kebenaran yang sama yang digunakan 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);
}Pemeriksaan kesehatan
Doconut mendaftarkan pemeriksaan kesehatan "doconut" yang melaporkan status lisensi. Classic ASP.NET tidak memiliki endpoint kesehatan sendiri, jadi tampilkan dari sebuah controller:
// GET /Health - Doconut mendaftarkan pemeriksaan kesehatan "doconut" yang melaporkan status lisensi:
// Sehat (valid), Menurun (percobaan atau tidak ada file lisensi), Tidak sehat (ditolak atau kedaluwarsa).
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");
}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 langganan telah lewat dan paket yang dirilis setelahnya akan ditolak — build saat ini tetap merender bersih. Lihat DoconutHost untuk nilai status.
Peningkatan versi
Sebuah 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 sebuah LicenseException (alasan ada di License.RejectionMessage) — sengaja gagal cepat, sehingga build yang usang atau tidak berlisensi terdeteksi saat penyebaran alih-alih secara diam-diam menandai output produksi. Perbarui langganan, ganti .lic di wwwroot, dan daur ulang pool aplikasi sehingga DoconutHost.Initialize memuat lisensi baru.
Apakah halaman ini membantu?