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