הגדרת רישיון
היכן Doconut מחפש את קובץ הרישיון שלך
ללא רישיון, Doconut עדיין מציג מסמכים — כל דף מציג סימן מים של הערכה. דף זה מסביר את ארבעת הדרכים לספק רישיון, ואת סדר העדיפויות המדויק כאשר מוגדר יותר מאחד.
ארבע דרכים לספק רישיון
יש ארבע: שלושה מקורות מפורשים בDoconutOptions — זרם, תוכן גולמי, או נתיב קובץ — בנוסף לגילוי אוטומטי כאשר אף אחד מהם אינו מוגדר. כאשר מוגדר יותר מאחד, סדר העדיפויות הוא מדויק:
LicenseStream מנצח על LicenseContent מנצח על LicensePath מנצח על חיפוש אוטומטי.
לפי נתיב
LicensePath מועבר לFile.Exists בדיוק כפי שניתן. נתיב יחסי נפתר ביחס לספריית העבודה הנוכחית של התהליך — לא לתיקיית הפרויקט שלך, ולא לתיקייה שבה נמצא Program.cs. אם הנתיב אינו נפתר, Doconut לא זורק שגיאה ולא לא נופל חזרה לחיפוש אוטומטי — הוא פשוט לא טוען רישיון והצופה מציג סימן מים. חיפוש אוטומטי פועל רק כאשר אף אחד מLicensePath, LicenseContent, או LicenseStream אינו מוגדר. קבצי הרישיון של כל תוסף באותה תיקייה (Doconut.Viewer.<Capability>.lic) נקראים יחד איתו, כך שLicensePath וAddPlugin<...>() פועלים יחד כאשר רישיונות התוסף נמצאים לצד רישיון הבסיס.
העדף נתיב מוחלט (לדוגמה שנבנה מIWebHostEnvironment.WebRootPath או AppContext.BaseDirectory), או דלג על LicensePath לחלוטין והסתמך על גילוי אוטומטי למטה.
builder.Services.AddDoconut(options =>
{
options.LicensePath = Path.Combine(AppContext.BaseDirectory, "wwwroot", "Doconut.Viewer.lic");
});באמצעות זרם
LicenseStream נקרא פעם אחת בעת האתחול — שימושי כאשר הרישיון מגיע ממאגר סודי במקום מקובץ על הדיסק.
// קדימות: LicenseStream > LicenseContent > LicensePath > חיפוש אוטומטי.
builder.Services.AddDoconut(options =>
{
options.LicenseStream = licenseStream;
});באמצעות תוכן
LicenseContent מקבל את טקסט הרישיון עצמו — ממשתנה סביבתי, ממסד נתונים, או ממנהל סודות:
// קובץ XML של רישיון ממסד נתונים, משתנה סביבתי, או מנהל סודות —
// אין קובץ על הדיסק. נגרע רק על ידי LicenseStream.
builder.Services.AddDoconut(options =>
{
options.LicenseContent = Environment.GetEnvironmentVariable("DOCONUT_LICENSE") ?? "";
});גילוי אוטומטי
אל תגדיר אף אחד משלושת המקורות המפורשים, ו‑Doconut יחפש את הרישיון בעצמו:
// אל תגדיר דבר, ו‑Doconut יחפש את הרישיון בעצמו, רק בשתי התיקיות האלה:
// 1. {CurrentDirectory}/wwwroot
// 2. {AppContext.BaseDirectory}/wwwroot (wwwroot בתוך תיקיית הפלט של הבנייה)
// הוא מחפש תחילה את Doconut.lic; אם חסר, אז Doconut.Viewer.lic ועוד
// קבצי Doconut.Viewer.<Capability>.lic לכל תוסף.
builder.Services.AddDoconut();תיקיות החיפוש, לפי סדר, וקבצי השמות, לפי סדר (כל קובץ נבדק בתיקייה 1, ואז בתיקייה 2):
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-plugin licenses, read only when Doconut.Viewer.lic was foundשום דבר מחוץ לתיקייה wwwroot אינו נקרא: .lic בתיקיית הפלט עצמה, או בwwwroot/lib, מתעלמים ממנו.
העתק את הרישיון לתיקיית הפלט שלך
כאשר התהליך אינו רץ מתיקיית הפרויקט — אפליקציה מפורסמת, IIS, מכולה, מריץ מבחנים — הבדיקה הראשונה מפספסת, והשנייה, {AppContext.BaseDirectory}/wwwroot, חייבת למצוא את הקובץ. יעד MSBuild זה מעתיק את הרישיונות לשם בכל בנייה:
<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. רישיון זמני שפג תוקפו ממשיך במצב עם סימן מים. רישיון בתשלום שתאריך המנוי שלו עבר ממשיך לעבוד, נקי ועם היכולות שלו, על כל בנייה ששוחררה לפני תאריך זה.
תוספים דורשים יכולות
רישום תוסף ללא זכאות תואמת הוא שונה: עבור רישיון חסר, קובץ TRIAL מיושן, או רישיון בתשלום ללא היכולת הזאת, AddDoconut() זורק InvalidOperationException, ולכן האפליקציה לא מתחילה. לדוגמה, רישום תוסף Converter ללא רישיון שמעניק Converter:
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<...>() עבור תוסף זה, או להתקין רישיון בתשלום או רישיון זמני/דמו (NFR) פעיל שמעניק את היכולת. רישומים זמניים מורשים לשרוד את תאריך הפקתם כך שאפליקציה שכבר הוגדרה יכולה להתדרדר בזמן ריצה במקום לקרוס בזמן הפעלה מחדש; לאחר שפג תוקף, היכולות שלהם עדיין מבוטלות.
אימות הרישיון הטעון
השתמש בIDoconutLicenseService, אותו מקור אמת שבו משתמש ה‑SDK, כדי לחשוף נקודת קצה דיאגנוסטית מאומתת או כדי לנהל דגלי תכונה. אל תחזיר את תוכן הרישיון או מפתחות.
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 הוא כיום נכס תאימות ללא נתיב טעינה פעיל, ולכן החלפת קובץ רישיון דורשת הפעלה מחדש של היישום.
מטריצת פתרון בעיות
| סימפטום | סיבה סבירה | בדיקה |
|---|---|---|
| הצופה עובד אך כל דף מסומן במים | לא נטען רישיון, או שהרישיון הזמני פג תוקף | פתר את IDoconutLicenseService; אמת את תיקיית הפלט ואת תיקיית העבודה של התהליך |
AddDoconut() זורק עבור תוסף | הרישיון אינו מעניק את היכולת של תוסף זה | בדוק את IsCapabilityGranted(...) והסר רישומים שלא רכשת |
| נתיב יחסי מוגדר עובד מקומית אך לא ב‑IIS/קונטיינר | תיקיית העבודה של התהליך השתנתה | השתמש בAppContext.BaseDirectory או בנתיב מוחלט |
קובץ .lic שהוחלף אינו משפיע | שירות הרישיון הסינגלטון כבר נוצר | הפעל את היישום מחדש |
OpenDocumentAsync זורק LicenseException | חתימה, תחום, חלון גרסה, רשימה שחורה, או שער זמן ריצה של תוסף דחו את הרישיון | קרא את הודעת החריגה/דחייה מבלי לחשוף אותה ללקוחות לא מהימנים |
צעדים הבאים
- רישוי — יכולות, רמות רישיון, ואימות מה נטען בזמן ריצה.
- פתרון בעיות — סימני מים, רישיונות שנדחו, ושגיאות יכולת.
האם דף זה היה מועיל?