การให้สิทธิ์
ความสามารถ, ระดับใบอนุญาต, และบริการใบอนุญาต
หน้านี้เป็นเอกสารอ้างอิงเวลารันไทม์เกี่ยวกับวิธีที่ใบอนุญาตกำหนดพฤติกรรมของ Doconut: สิ่งที่แต่ละสถานะใบอนุญาตอนุญาต, วิธีที่ความสามารถได้รับการมอบให้, และวิธีตรวจสอบทั้งหมดจากโค้ด (สำหรับ การโหลด ใบอนุญาต, ดูที่ การตั้งค่าใบอนุญาต).
สถานะใบอนุญาตและหน้าที่ของแต่ละสถานะ
| สถานะ | เปิดเอกสารได้หรือไม่? | ลายน้ำ | ความสามารถ |
|---|---|---|---|
| ใบอนุญาตเต็ม (จ่ายแล้ว) (รุ่นนี้ถูกปล่อยก่อนวันที่สมัครสมาชิก) | ใช่ | ไม่มี | ที่ซื้อไว้ (Has* flags) |
| ใบอนุญาตชั่วคราว (Developer/NFR — ใบอนุญาตทดลอง, ก่อนวันหมดอายุ) | ใช่ | ไม่มีในตัวดูพื้นฐาน; ผลลัพธ์ของปลั๊กอินมีลายน้ำ | ทั้งหมด — มอบแบบทั่วถึง (ช่องทางทดลอง) |
ใบอนุญาตชั่วคราวที่หมดอายุ (หลังจากวันที่ LicenseExpiry) | ใช่ | ลายน้ำการประเมิน | ไม่มีการมอบ |
| ไม่มีไฟล์ใบอนุญาตเลย | ใช่ | ลายน้ำการประเมิน | ไม่มีการมอบ |
| พบแต่ถูกปฏิเสธ (ลายเซ็นไม่ถูกต้อง, ถูกดัดแปลง, อยู่ในบัญชีดำ, หรือรุ่นที่ปล่อยหลังจากวันที่สมัครสมาชิกของใบอนุญาต) | ไม่มี — LicenseException ในการเปิดทุกครั้ง | — | — |
ใบอนุญาตที่จ่ายแล้วซึ่งวันที่สมัครสมาชิกได้ผ่านไปแล้วยังคงทำงาน — สะอาด, พร้อมความสามารถของมัน — ในทุกรุ่นที่ปล่อยก่อนวันที่นั้น รุ่นที่ปล่อยหลังจากนั้นจะถูกปฏิเสธเท่านั้น.
สองผลลัพธ์ที่ควรทำความเข้าใจ:
- การไม่มีใบอนุญาตไม่ใช่ใบอนุญาตชั่วคราว. หากไม่มีไฟล์ใบอนุญาต, หน้าเว็บจะแสดงลายน้ำและไม่มีความสามารถใด ๆ (การค้นหา, การอธิบาย, ปลั๊กอิน) ทำงาน ประสบการณ์เต็มรูปแบบที่ไม่มีลายน้ำต้องการ ใบอนุญาตชั่วคราว จริง (รับหนึ่ง).
- เฉพาะใบอนุญาตที่ถูกปฏิเสธเท่านั้นที่บล็อกการเปิด. ใบอนุญาตชั่วคราวที่หมดอายุทำให้แอปทำงานต่อด้วยลายน้ำการประเมิน, และใบอนุญาตที่จ่ายแล้วที่พ้นวันที่สมัครสมาชิกยังคงแสดงผลสะอาดในรุ่นที่ครอบคลุม; แต่การปรับใช้รุ่นที่ปล่อย หลัง วันที่สมัครสมาชิกของใบอนุญาตจะถูกปฏิเสธและ ล้มเหลวอย่างรวดเร็ว ด้วย
LicenseException, ดังนั้นคุณจะจับได้ในขั้นตอนปรับใช้ — ไม่ใช่โดยการส่งออกที่มีลายน้ำโดยเงียบ ๆ ข้อยกเว้นนั้น (จากOpenDocumentAsync) มีเหตุผลมาจากLicense.RejectionMessage.
ความสามารถ
Doconut ควบคุมฟังก์ชันเสริมโดย ความสามารถ. มันครอบคลุมคุณลักษณะในตัว Search และ Annotation และปลั๊กอิน Converter, Dicom และ Signer ที่เปิดใช้งานตามสิทธิ์, แต่ละอย่างมอบโดยใบอนุญาตของคุณ ตัวดูพื้นฐานไม่ใช่ความสามารถ — เป็นเงื่อนไขเบื้องต้นที่แสดงเป็น IsViewerLicensed:
var lic = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // มีใบอนุญาต non-TRIAL และครอบคลุมเวอร์ชันของ build นี้ประตูเดียวที่ทั้งสายงานใช้คือ IsCapabilityGranted:
var lic = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();
bool searchGranted = lic.IsCapabilityGranted(LicenseCapability.Search);ตรรกะของมัน, ตรงจากการนำไปใช้: ใบอนุญาต ชั่วคราว ที่ใช้งานอยู่ (ไม่หมดอายุ) มอบ ทุก ความสามารถ — รวมถึงความสามารถที่ยังไม่มีแฟล็กการซื้อเฉพาะ; ใบอนุญาตที่ซื้อจริงมอบตามแฟล็ก Has* ของมันเท่านั้นและเป็น default-deny สำหรับสิ่งที่ไม่มีการแมป (ไฟล์ประเภท TRIAL เก่าไม่ใช่สิทธิ์ — ถือว่าไม่มีใบอนุญาต: มีลายน้ำ, ไม่มีการมอบใด ๆ).
ใบอนุญาตชั่วคราว
ใบอนุญาตชั่วคราว (Developer/NFR) จะถูกทำเครื่องหมายด้วยแท็ก ExpiryNote และมีวันที่หมดอายุที่กำหนดอย่างชัดเจน:
| สมาชิก | ความหมาย |
|---|---|
IsTemporary | แท็ก ExpiryNote ปรากฏ (การตรวจจับทำโดยการมีแท็ก — ไม่ตรงกับข้อความของโน้ต, เป็นแบบไดนามิก) |
ExpiryNote | ข้อความข้อมูลที่ฝังอยู่ในใบอนุญาต |
LicenseExpiry | วันที่หมดอายุที่กำหนดอย่างชัดเจน (DateTime?) |
ความหมายของการหมดอายุแตกต่างตามระดับ: ใบอนุญาตชั่วคราวหมดอายุใน วันที่ LicenseExpiry เท่านั้น (หน้าต่างการสมัครสมาชิกจะถูกละเลย; ใบอนุญาตชั่วคราวที่ไม่มีวันที่จะถือว่าหมดอายุ, ปลอดภัย). ใบอนุญาตอื่น ๆ ทั้งหมดหมดอายุในวันที่สมัครสมาชิก/หน้าต่างอัปเดต; สำหรับใบอนุญาตที่จ่ายแล้ว, IsExpired เพียงรายงานว่ามีการผ่านวันที่นั้น — รุ่นที่ปล่อยก่อนจะยังคงสะอาดและรักษาความสามารถของมัน.
IDoconutLicenseService อ้างอิง
Resolve IDoconutLicenseService (namespace Doconut.Core.Interfaces) from DoconutHost.Services. It is a singleton — the license is parsed once, in DoconutHost.Initialize:
| สมาชิก | ความหมาย |
|---|---|
License | สแนปช็อตเต็มของ DoconutLicenseInfo (ด้านล่าง) |
IsTrial | ไฟล์ประเภท TRIAL แบบ legacy (ถือว่าไม่มีใบอนุญาต — ไม่ใช่สิทธิ์) |
IsTemporary / ExpiryNote / LicenseExpiry | เครื่องหมายใบอนุญาตชั่วคราว |
IsExpired | หมดอายุตามกฎระดับข้างต้น |
IsVersionValid | บิลด์นี้อยู่ในช่วงการสนับสนุนของใบอนุญาต |
IsViewerLicensed | พบไฟล์ Non-TRIAL และ เวอร์ชันที่ครอบคลุม — ข้อกำหนดพื้นฐาน |
IsCapabilityGranted(cap) | ประตูความสามารถเดียว |
HasSearch HasAnnotation HasEditor HasConverter HasDicom HasDocumentTools HasSigner HasRedactor HasComparer HasForms HasProtector HasCompressor | หนึ่งแฟล็กต่อความสามารถ: ซื้อโดยใบอนุญาตที่ครอบคลุมบิลด์นี้, หรือได้รับจากใบอนุญาต Temporary ที่ใช้งานอยู่. IsCapabilityGranted ตอบคำถามเดียวกันตามความสามารถ |
IsValidForDomain(host) | การครอบคลุมโฮสต์; ใบอนุญาต V4 ใช้ไวลด์การ์ด *.* |
LicenseRejectionReason | ไม่ว่าง ⇒ การเปิดจะถูกบล็อกด้วยข้อความนี้ |
DoconutLicenseInfo เปิดเผยสแนปช็อตที่เป็นมิตรต่อการแสดงผลสำหรับแผงผู้ดูแล: Owner, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, แฟล็ก Has*, ฟิลด์ใบอนุญาตชั่วคราว, และ RejectionMessage.
// GET /Features - ทำ feature-flag UI ของคุณจากแหล่งความจริงเดียวกันที่ 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);
}การตรวจสุขภาพ
Doconut ลงทะเบียนการตรวจสุขภาพ "doconut" ที่รายงานสถานะใบอนุญาต. Classic ASP.NET ไม่มี endpoint ตรวจสุขภาพของตนเอง, ดังนั้นให้เปิดเผยจากคอนโทรลเลอร์:
// GET /Health - Doconut ลงทะเบียนการตรวจสุขภาพ "doconut" ที่รายงานสถานะใบอนุญาต:
// สุขภาพดี (ถูกต้อง), ลดลง (ทดลองหรือไม่มีไฟล์ใบอนุญาต), ไม่สุขภาพดี (ถูกปฏิเสธหรือหมดอายุ)
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");
}เชื่อมต่อเข้ากับระบบเฝ้าระวังของคุณและการสมัครสมาชิกที่กำลังหมดอายุจะกลายเป็นการแจ้งเตือนแทนตั๋วสนับสนุน. การตรวจสอบรายงาน Unhealthy เมื่อใบอนุญาตถูกปฏิเสธหรือ IsExpired เป็นจริง; สำหรับใบอนุญาตที่ชำระเงิน, หมายความว่าวันที่สมัครสมาชิกได้ผ่านไปและแพคเกจที่ออกหลังจากนั้นจะถูกปฏิเสธ — บิลด์ปัจจุบันยังคงแสดงผลอย่างสะอาด. ดู โฮสต์Doconut สำหรับค่าของสถานะ.
การอัปเกรดเวอร์ชัน
ใบอนุญาตครอบคลุม หน้าต่างเวอร์ชัน. การอัปเดตแพคเกจ NuGet ไปยังบิลด์ที่ ใหม่กว่า หน้าต่างนั้นทำให้ใบอนุญาตไม่ถูกต้องสำหรับบิลด์นี้: IsVersionValid กลายเป็น false และ การเปิดถูกบล็อก ด้วย LicenseException (เหตุผลอยู่ใน License.RejectionMessage) — ตั้งใจให้ล้มเหลวอย่างรวดเร็ว, เพื่อให้บิลด์ที่ล้าสมัยหรือไม่มีใบอนุญาตถูกจับได้ในขั้นตอนการปรับใช้แทนที่จะทำเครื่องหมายลายน้ำโดยเงียบ ๆ ในผลลัพธ์การผลิต. ต่ออายุการสมัคร, แทนที่ .lic ใน wwwroot, และรีไซเคิลพูลแอปพลิเคชันเพื่อให้ DoconutHost.Initialize โหลดใบอนุญาตใหม่.
หน้านี้เป็นประโยชน์หรือไม่?