การให้สิทธิ์ใช้งาน

ความสามารถ, ระดับใบอนุญาต, และบริการใบอนุญาต

หน้านี้เป็นเอกสารอ้างอิงขณะทำงานเกี่ยวกับวิธีที่ใบอนุญาตกำหนดพฤติกรรมของ Doconut: สิ่งที่แต่ละสถานะของใบอนุญาตอนุญาต, วิธีที่ความสามารถถูกมอบให้, และวิธีตรวจสอบทั้งหมดจากโค้ด (สำหรับ loading ใบอนุญาต, ดู Getting Started → License Setup.)

สถานะใบอนุญาตและสิ่งที่ทำ

สถานะเปิดเอกสารได้?ลายน้ำความสามารถ
Full (paid) license (ภายในช่วงการสมัครสมาชิก/อัปเดตของมัน)ใช่ไม่มีที่ซื้อไว้ (Has* flags)
Temporary license (Developer/NFR — ใบอนุญาตประเมิน, ก่อนวันหมดอายุ)ใช่ไม่มีAll — การให้สิทธิ์ทั้งหมด (ช่องทางประเมิน)
Expired (ใบอนุญาตชั่วคราวที่หมดอายุแล้ว, หรือการสมัครสมาชิกที่จ่ายแล้วที่เกินวันต่ออายุ)ใช่ลายน้ำการประเมินไม่มีการให้สิทธิ์
No license file at allใช่ลายน้ำการประเมินไม่มีการให้สิทธิ์
Found but rejected (ลายเซ็นไม่ถูกต้อง, ถูกดัดแปลง, ถูกบล็อก, หรือบิลด์ใหม่กว่าช่วงเวอร์ชันของใบอนุญาต)ไม่ — LicenseException on every open——

สองผลสรุปที่ควรจดจำ:

  • ใบอนุญาตที่หายไปไม่ใช่ใบอนุญาตชั่วคราว. เมื่อไม่มีไฟล์ใบอนุญาต, หน้าเว็บจะแสดงลายน้ำและไม่มีความสามารถใดๆ (การค้นหา, การอธิบาย, ปลั๊กอิน) ทำงาน. ประสบการณ์เต็มรูปแบบโดยไม่มีลายน้ำต้องการ Temporary license จริง (รับหนึ่ง).
  • เฉพาะใบอนุญาตที่ถูกปฏิเสธเท่านั้นที่บล็อกการเปิด. การหมดอายุของปฏิทิน/การสมัครสมาชิกจะทำให้การแสดงผลเป็นลายน้ำ; แต่การปรับใช้บิลด์ newer than หน้าต่างเวอร์ชันของใบอนุญาตจะถูกปฏิเสธและ fails fast ด้วย LicenseException, ดังนั้นคุณจะจับได้ในขั้นตอนปรับใช้ — ไม่ได้โดยการส่งออกลายน้ำโดยเงียบ. ข้อยกเว้นนั้น (จาก OpenDocumentAsync) จะบรรจุเหตุผลจาก License.RejectionMessage.

ความสามารถ

Doconut ควบคุมฟังก์ชันเสริมโดย capability. ปัจจุบันมีปลั๊กอิน Converter และ DICOM ที่ต้องเปิดใช้งาน รวมถึงฟีเจอร์ในตัว Search และ Annotation, แต่ละอย่างได้รับสิทธิจากใบอนุญาตของคุณ. ตัวดูพื้นฐานไม่ใช่ capability — เป็นเงื่อนไขพื้นฐาน, แสดงเป็น IsViewerLicensed:

csharp
bool viewerLicensed = lic.IsViewerLicensed; // non-TRIAL license present AND covering this build's version

ประตูเดียวที่ทั้ง pipeline ใช้คือ IsCapabilityGranted:

csharp
bool searchGranted = lic.IsCapabilityGranted(LicenseCapability.Search);

ตรรกะของมัน, ตามต้นฉบับจากการทำงาน: ใบอนุญาต Temporary ที่ใช้งานอยู่ (ไม่หมดอายุ) จะให้สิทธิ every ความสามารถ — รวมถึงความสามารถที่ยังไม่มีแฟล็กการซื้อเฉพาะ; ใบอนุญาตที่ซื้อจริงจะให้สิทธิเท่ากับแฟล็ก Has* ของมันและเป็น default-deny สำหรับสิ่งที่ไม่ได้แมป (ไฟล์แบบ TRIAL เก่าเป็น not สิทธิ์ — ถือว่าไม่มีใบอนุญาต: มีลายน้ำ, ไม่ได้ให้สิทธิ์ใดๆ).

ใบอนุญาตชั่วคราว

ใบอนุญาตชั่วคราว (Developer/NFR) จะถูกทำเครื่องหมายด้วยแท็ก ExpiryNote และมีวันหมดอายุที่กำหนด:

สมาชิกความหมาย
IsTemporaryมีแท็ก ExpiryNote ปรากฏ (การตรวจจับทำโดยการมีแท็ก — ไม่จับคู่กับข้อความของโน้ต, เป็นแบบไดนามิก)
ExpiryNoteข้อความข้อมูลที่ฝังอยู่ในใบอนุญาต
LicenseExpiryวันหมดอายุที่กำหนด (DateTime?)

ความหมายของวันหมดอายุแตกต่างตามระดับ: ใบอนุญาตชั่วคราวจะหมดอายุที่ LicenseExpiry date only (ละเว้นช่วงการสมัครสมาชิก; ใบอนุญาตชั่วคราวที่ไม่มีวันหมดอายุจะถือว่าหมดอายุ, ปลอดภัย). ใบอนุญาตอื่นทั้งหมดจะหมดอายุที่วันในช่วงการสมัครสมาชิก/อัปเดตของมัน.

อ้างอิง IDoconutLicenseService

Inject IDoconutLicenseService (namespace Doconut.Core.Interfaces; registered as a singleton — the license is parsed once at startup):

สมาชิกความหมาย
Licenseสแนปชอตเต็มของ DoconutLicenseInfo (ด้านล่าง)
IsTrialไฟล์แบบ TRIAL เก่า (ถือว่าไม่มีใบอนุญาต — ไม่ใช่สิทธิ์)
IsTemporary / ExpiryNote / LicenseExpiryตัวบ่งชี้ใบอนุญาตชั่วคราว
IsExpiredหมดอายุตามกฎระดับที่กล่าวข้างต้น
IsVersionValidบิลด์นี้อยู่ในช่วงสนับสนุนของใบอนุญาต
IsViewerLicensedพบไฟล์ที่ไม่ใช่ TRIAL และ เวอร์ชันครอบคลุม — เงื่อนไขพื้นฐาน
IsCapabilityGranted(cap)ประตูความสามารถเดียว
HasSearch HasAnnotation HasConverter HasDicomปล่อยตามแฟล็กการซื้อของแต่ละความสามารถ — ใช้ IsCapabilityGranted เพื่อคำตอบที่รับรู้ใบอนุญาตชั่วคราว
IsValidForDomain(host)การครอบคลุมโฮสต์; ใบอนุญาต V4 ใช้ไวลด์การ์ด *.*
LicenseRejectionReasonไม่ว่าง ⇒ การเปิดถูกบล็อกด้วยข้อความนี้

DoconutLicenseInfo เปิดเผยสแนปชอตที่เป็นมิตรต่อการแสดงผลสำหรับแผงผู้ดูแล: Owner, Email, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, แฟล็ก Has*, ฟิลด์ใบอนุญาตชั่วคราว, และ RejectionMessage.

csharp
// Feature-flag your UI from the same source of truth the SDK uses
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() registers a "doconut" health check that reports license/expiry state through the standard ASP.NET Core mechanism:

csharp
app.MapHealthChecks("/health");

เชื่อมต่อเข้ากับระบบมอนิเตอร์ของคุณและการสมัครสมาชิกที่กำลังจะหมดอายุจะกลายเป็นการแจ้งเตือนแทนการเปิดตั๋วสนับสนุน.

การอัปเกรดเวอร์ชัน

ใบอนุญาตครอบคลุม version window. การอัปเดตแพ็กเกจ NuGet ไปยังบิลด์ newer than หน้าต่างนั้นทำให้ใบอนุญาตไม่ถูกต้องสำหรับบิลด์นี้: IsVersionValid กลายเป็น false และ opening is blocked ด้วย LicenseException (เหตุผลอยู่ใน License.RejectionMessage) — ตั้งใจให้ล้มเหลวอย่างรวดเร็ว, เพื่อให้บิลด์ที่ล้าสมัยหรือไม่มีใบอนุญาตถูกจับได้ในขั้นตอนปรับใช้แทนการใส่ลายน้ำโดยเงียบในผลลัพธ์การผลิต. ต่ออายุการสมัคร, แทนที่ไฟล์ .lic, และรีสตาร์ทแอปพลิเคชันเพื่อให้ AddDoconut() โหลดใบอนุญาตใหม่.

หน้านี้เป็นประโยชน์หรือไม่?