การตั้งค่าใบอนุญาต

ที่ที่ Doconut มองหาไฟล์ใบอนุญาตของคุณ

หากไม่มีใบอนุญาต Doconut ยังสามารถแสดงเอกสารได้ — แต่ทุกหน้าจะมีลายน้ำการประเมินผล หน้านี้อธิบายวิธีสี่วิธีในการจัดหาใบอนุญาต และลำดับความสำคัญที่แน่นอนเมื่อมีการตั้งค่ามากกว่าหนึ่งวิธี

ใบอนุญาตจะถูกโหลด หนึ่งครั้ง, ระหว่าง AddDoconut(). นี่เป็นการเปลี่ยนแปลงจากไลบรารี .NET Standard ก่อนหน้า, ที่ซึ่งใบอนุญาตถูกส่งให้กับอินสแตนซ์ Viewer หรือกำหนดผ่านการเรียกใช้แบบสแตติก Viewer.DoconutLicense(...) / Viewer.SetLicensePlugin(...). วิธีเหล่านั้นไม่ได้เป็นกลไกการเริ่มต้นในรุ่นนี้ — ดูที่ คู่มือการย้าย.

สี่วิธีในการจัดหาใบอนุญาต

มีทั้งหมดสี่วิธี: แหล่งที่มาชัดเจนสามแหล่งบน DoconutOptions — สตรีม, เนื้อหาดิบ, หรือเส้นทางไฟล์ — พร้อมกับการค้นหาอัตโนมัติเมื่อไม่มีการตั้งค่าใด ๆ เมื่อมีการตั้งค่ามากกว่าหนึ่งแหล่ง ลำดับความสำคัญจะเป็นตามที่แน่นอน:

LicenseStream ชนะ LicenseContent ชนะ LicensePath ชนะ การค้นหาอัตโนมัติ.

ตามเส้นทาง

LicensePath จะถูกส่งไปยัง File.Exists อย่างที่กำหนดไว้ เส้นทางสัมพัทธ์จะอ้างอิงกับ ไดเรกทอรีทำงานปัจจุบัน ของกระบวนการ — ไม่ใช่โฟลเดอร์โปรเจกต์ของคุณ, และไม่ใช่โฟลเดอร์ที่ Program.cs อยู่ หากเส้นทางไม่สามารถแก้ไขได้ Doconut จะไม่โยนข้อผิดพลาดและ ไม่ กลับไปใช้การค้นหาอัตโนมัติ — มันจะโหลดไม่มีใบอนุญาตและตัวดูเอกสารจะแสดงลายน้ำ การค้นหาอัตโนมัติจะทำงานเฉพาะเมื่อไม่มีการตั้งค่า LicensePath, LicenseContent, หรือ LicenseStream ไฟล์ใบอนุญาต per‑plugin ในโฟลเดอร์เดียวกัน (Doconut.Viewer.<Capability>.lic) จะถูกอ่านพร้อมกับมัน, ดังนั้น LicensePath และ AddPlugin<...>() จะทำงานร่วมกันเมื่อใบอนุญาตของปลั๊กอินอยู่ข้างๆ ใบอนุญาตหลัก

ควรใช้เส้นทางแบบเต็ม (เช่น สร้างจาก IWebHostEnvironment.WebRootPath หรือ AppContext.BaseDirectory), หรือข้าม LicensePath อย่างเต็มและพึ่งพาการค้นหาอัตโนมัติตามด้านล่าง

csharp
builder.Services.AddDoconut(options =>
{
    options.LicensePath = Path.Combine(AppContext.BaseDirectory, "wwwroot", "Doconut.Viewer.lic");
});

ตามสตรีม

LicenseStream จะถูกอ่านหนึ่งครั้งเมื่อเริ่มต้น — มีประโยชน์เมื่อใบอนุญาตมาจากที่เก็บความลับแทนไฟล์บนดิสก์

csharp
// ลำดับความสำคัญ: LicenseStream > LicenseContent > LicensePath > auto-search.
builder.Services.AddDoconut(options =>
{
    options.LicenseStream = licenseStream;
});

ตามเนื้อหา

LicenseContent ยอมรับข้อความใบอนุญาตโดยตรง — จากตัวแปรสภาพแวดล้อม, ฐานข้อมูล, หรือผู้จัดการความลับ:

csharp
// License XML จากฐานข้อมูล, ตัวแปรสภาพแวดล้อม, หรือ secret manager —
// ไม่มีไฟล์บนดิสก์. มีเพียง LicenseStream เท่านั้นที่เหนือกว่า.
builder.Services.AddDoconut(options =>
{
    options.LicenseContent = Environment.GetEnvironmentVariable("DOCONUT_LICENSE") ?? "";
});

การค้นหาอัตโนมัติ

ไม่กำหนดแหล่งที่มาชัดเจนทั้งสาม, Doconut จะค้นหาใบอนุญาตด้วยตนเอง:

csharp
// ไม่ต้องกำหนดค่าอะไรเลย, และ Doconut จะค้นหาไลเซนส์ด้วยตนเอง, ในสองโฟลเดอร์ต่อไปนี้เท่านั้น:
//   1. {CurrentDirectory}/wwwroot
//   2. {AppContext.BaseDirectory}/wwwroot   (wwwroot ภายในโฟลเดอร์ผลลัพธ์การสร้าง)
// มันจะมองหา Doconut.lic ก่อน; หากไม่มี, จะมองหา Doconut.Viewer.lic พร้อมกับ
// ไฟล์ Doconut.Viewer.<Capability>.lic ตามความสามารถแต่ละอย่าง.
builder.Services.AddDoconut();

โฟลเดอร์สำรวจตามลำดับ, และชื่อไฟล์ที่ค้นหา:

text
1. {CurrentDirectory}/wwwroot
2. {AppContext.BaseDirectory}/wwwroot

Filenames, in order (each one looked for in folder 1, then folder 2):
  Doconut.lic                          — legacy all-in-one license; if found, nothing else is read
  Doconut.Viewer.lic                   — base viewer license
  Doconut.Viewer.<Capability>.lic      — per-capability licenses, read only when Doconut.Viewer.lic was found

ไม่มีอะไรนอกโฟลเดอร์ wwwroot ถูกอ่าน: .lic ในโฟลเดอร์ผลลัพธ์เอง, หรือใน wwwroot/lib, จะถูกละเลย

หากคุณเคยส่ง List<string> ของเส้นทางใบอนุญาตไปยังคอนสตรัคเตอร์ Viewer — หนึ่งต่อความสามารถ — ให้เก็บไฟล์คู่เหล่านั้นไว้ข้างๆ Doconut.Viewer.lic และให้การค้นหาอัตโนมัติดึงขึ้นมา ไม่มีตัวเลือกรายการเส้นทางบน DoconutOptions.

คัดลอกใบอนุญาตไปยังโฟลเดอร์ผลลัพธ์ของคุณ

เมื่อกระบวนการไม่ได้ทำงานจากโฟลเดอร์โครงการ — แอปที่เผยแพร่, IIS, คอนเทนเนอร์, ตัวรันเทสต์ — การตรวจสอบครั้งแรกไม่พบไฟล์, และการตรวจสอบครั้งที่สอง, {AppContext.BaseDirectory}/wwwroot, ต้องค้นหาไฟล์นั้น. เป้าหมาย MSBuild นี้จะคัดลอกใบอนุญาตไปที่นั่นในทุกการสร้าง:

xml
<Target Name="CopyLicensesToOutput" AfterTargets="Build">
  <ItemGroup>
    <DoconutLicenseFiles Include="$(MSBuildProjectDirectory)\wwwroot\*.lic" />
    <StaleOutputLicenses Include="$(OutDir)wwwroot\*.lic" />
  </ItemGroup>
  <!-- ลบก่อน, ดังนั้นการเปลี่ยนชื่อหรือการลบ .lic ใน wwwroot จะทำให้มันออกจากผลลัพธ์ด้วย -->
  <Delete Files="@(StaleOutputLicenses)" />
  <Copy SourceFiles="@(DoconutLicenseFiles)" DestinationFolder="$(OutDir)wwwroot" />
</Target>

ตำแหน่งปลายทางต้องเป็น $(OutDir)wwwroot: .lic ที่คัดลอกไปยังรากของผลลัพธ์จะไม่ถูกค้นหาโดยการค้นหาอัตโนมัติ. ตัวอย่าง LicensePath บนหน้านี้ชี้ไปยังตำแหน่งเดียวกัน.

อย่าเก็บไฟล์ .lic ไว้ในระบบควบคุมเวอร์ชัน — ปล่อยไฟล์เหล่านั้นพร้อมกับแอป, หรือแทรกใบอนุญาตผ่าน LicenseContent หรือ LicenseStream จากที่เก็บความลับของคุณ.

สิ่งที่จะเกิดขึ้นหากไม่มีใบอนุญาต

การไม่มีใบอนุญาตจะไม่ทำให้เกิดข้อยกเว้น. AddDoconut() สำเร็จ, แอปเริ่มทำงาน, และตัวดูทำงาน — แต่ทุกหน้าจะมีลายน้ำการประเมินและไม่มีความสามารถเสริมใดๆ ถูกมอบให้.

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

ปลั๊กอินต้องการความสามารถ

การลงทะเบียนปลั๊กอินที่ไม่มีสิทธิ์ที่สอดคล้องกันจะแตกต่าง: สำหรับกรณีไม่มีใบอนุญาต, ไฟล์ legacy TRIAL, หรือใบอนุญาตที่ชำระเงินที่ไม่มีความสามารถนั้น, AddDoconut() จะขว้างข้อยกเว้น InvalidOperationException, ทำให้แอปไม่เริ่มทำงาน. ตัวอย่างเช่น, การลงทะเบียนปลั๊กอิน Converter โดยไม่มีใบอนุญาตที่มอบ Converter:

text
InvalidOperationException: The Converter plugin is registered via AddPlugin but no active
license grants Converter. Remove the AddPlugin<...>() call or install a license (or
trial/demo) that includes Converter.

ข้อความบอกวิธีแก้โดยตรง: หรือเอาการเรียก options.AddPlugin<...>() สำหรับปลั๊กอินนั้นออก, หรือทำการติดตั้งใบอนุญาตที่ชำระเงินหรือใบอนุญาต Temporary/Demo (NFR) ที่ใช้งานได้ซึ่งมอบความสามารถนั้น. การลงทะเบียนแบบ Temporary จะได้รับอนุญาตให้คงอยู่หลังจากวันที่หมดอายุเพื่อให้แอปที่กำหนดค่าแล้วสามารถทำงานในโหมดลดคุณภาพได้ในขณะรันแทนที่จะพังระหว่างการรีสตาร์ท; เมื่อหมดอายุแล้ว ความสามารถของมันยังคงถูกยกเลิก.

ตรวจสอบใบอนุญาตที่โหลด

ใช้ IDoconutLicenseService, แหล่งความจริงเดียวกันที่ SDK ใช้, เพื่อเปิดเผย endpoint การวินิจฉัยที่ผ่านการรับรองหรือเพื่อควบคุมฟีเจอร์ฟล็อก. อย่าเปิดเผยเนื้อหาใบอนุญาตหรือคีย์.

csharp
app.MapGet("/api/doconut/license", (IDoconutLicenseService license) => Results.Ok(new
{
    viewer = license.IsViewerLicensed || license.IsTemporary,
    temporary = license.IsTemporary,
    search = license.IsCapabilityGranted(LicenseCapability.Search),
    annotation = license.IsCapabilityGranted(LicenseCapability.Annotation),
    converter = license.HasConverter,
    dicom = license.HasDicom
}));

ใบอนุญาตจะถูกอ่านระหว่างการลงทะเบียน AddDoconut(). ResetLicense ปัจจุบันเป็นคุณสมบัติความเข้ากันได้ที่ไม่มีเส้นทางรีโหลดที่ทำงาน, ดังนั้นการแทนที่ไฟล์ใบอนุญาตต้องรีสตาร์ทแอปพลิเคชัน.

ตารางการแก้ไขปัญหา

อาการสาเหตุที่เป็นไปได้ตรวจสอบ
ตัวดูทำงานแต่ทุกหน้ามีลายน้ำไม่ได้โหลดใบอนุญาต, หรือใบอนุญาต Temporary หมดอายุแก้ไข IDoconutLicenseService; ตรวจสอบไดเรกทอรีผลลัพธ์และไดเรกทอรีทำงานของกระบวนการ
AddDoconut() ขว้างข้อยกเว้นสำหรับปลั๊กอินใบอนุญาตไม่มอบความสามารถของปลั๊กอินนั้นตรวจสอบ IsCapabilityGranted(...) และลบการลงทะเบียนที่คุณไม่ได้ซื้อ
เส้นทางสัมพัทธ์ที่กำหนดค่าทำงานในเครื่องท้องถิ่นแต่ไม่ทำงานใน IIS/คอนเทนเนอร์ไดเรกทอรีทำงานของกระบวนการเปลี่ยนไปใช้ AppContext.BaseDirectory หรือเส้นทางแบบเต็ม
ไฟล์ .lic ที่แทนที่ไม่มีผลบริการใบอนุญาตแบบ singleton ถูกสร้างแล้วรีสตาร์ทแอปพลิเคชัน
OpenDocumentAsync ขว้าง LicenseExceptionลายเซ็น, โดเมน, ช่วงเวอร์ชัน, รายการดำ, หรือประตูรันไทม์ของปลั๊กอินปฏิเสธใบอนุญาตอ่านข้อความข้อยกเว้น/การปฏิเสธโดยไม่เปิดเผยต่อไคลเอนต์ที่ไม่เชื่อถือ
ใบอนุญาตแบบตามความสามารถทำงานก่อนหน้านี้แต่ไม่ทำงานตอนนี้โค้ดเก่าได้ส่งเส้นทางใบอนุญาตโดยตรงไปยังคอนสตรัคเตอร์ Viewerย้ายไฟล์ .lic คู่กันไปไว้ข้างๆ Doconut.Viewer.lic และให้การค้นหาอัตโนมัติโหลดมัน

ขั้นตอนต่อไป

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

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