การให้สิทธิ์

ความสามารถ, ระดับสิทธิ์, และบริการสิทธิ์

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

สถานะของสิทธิ์และสิ่งที่ทำ

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

ใบอนุญาตที่จ่ายแล้วที่วันที่สมัครสมาชิกได้ผ่านไปแล้วยังคงทำงาน — สะอาด, พร้อมความสามารถของมัน — ในทุกการสร้างที่ปล่อยก่อนวันที่นั้น. เฉพาะการสร้างที่ปล่อยหลังจากนั้นจะถูกปฏิเสธ.

สองผลลัพธ์ที่ควรทำความเข้าใจ:

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

ความสามารถ

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

csharp
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // มีใบอนุญาต non-TRIAL อยู่ AND ครอบคลุมเวอร์ชันของ build's

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

csharp
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool searchGranted = lic.IsCapabilityGranted(LicenseCapability.Search);

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

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

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

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

ความหมายของวันหมดอายุแตกต่างตามระดับ: ใบอนุญาตชั่วคราวหมดอายุที่ 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หนึ่งแฟล็กต่อความสามารถ: ซื้อโดยใบอนุญาตที่ครอบคลุมการสร้างนี้, หรือมอบโดยใบอนุญาต Temporary ที่ใช้งาน. IsCapabilityGranted ตอบคำถามเดียวกันตามความสามารถ
IsValidForDomain(host)การครอบคลุมโฮสต์; ใบอนุญาต V4 ใช้ wildcard *.*
LicenseRejectionReasonไม่ว่าง ⇒ การเปิดจะถูกบล็อกด้วยข้อความนี้

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

csharp
// ใช้ 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:

csharp
app.MapHealthChecks("/health");

เชื่อมต่อเข้ากับการตรวจสอบของคุณและการสมัครสมาชิกที่กำลังหมดอายุจะกลายเป็นการแจ้งเตือนแทนตั๋วสนับสนุน. การตรวจสอบรายงาน Unhealthy เมื่อใบอนุญาตถูกปฏิเสธหรือ IsExpired เป็นจริง; สำหรับใบอนุญาตที่จ่ายแล้ว, หมายความว่าวันที่สมัครสมาชิกได้ผ่านไปแล้วและแพคเกจที่ปล่อยหลังจากนั้นจะถูกปฏิเสธ — การสร้างปัจจุบันยังคงแสดงผลสะอาด.

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

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

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