הגדרת רישיון

היכן Doconut מחפש את קובץ הרישיון שלך תחת IIS

בלי רישיון, Doconut עדיין מציג מסמכים — כל דף מציג סימן מים של הערכה. דף זה מסביר את ארבעת הדרכים לספק רישיון בGlobal.asax, היכן ש‑Doconut מחפש כאשר אינך מספק רישיון, ומה קורה כאשר רישיון של תוסף חסר.

ארבע דרכים לספק רישיון

יש שלושה מקורות מפורשים בDoconutOptions — נתיב קובץ, זרם, או תוכן גולמי — בנוסף לגילוי אוטומטי כאשר אף אחד מהם לא מוגדר. כולם נקראים פעם אחת, בDoconutHost.Initialize. כאשר מוגדרים יותר מאחד, סדר העדיפויות הוא מדויק:

LicenseStream גובר על LicenseContent גובר על LicensePath גובר על גילוי אוטומטי.

לפי נתיב

תן לLicensePath נתיב מלא. נתיב יחסי נפתר ביחס לתיקיית העבודה של התהליך, וב‑IIS זו תיקיית תהליך העובד עצמו, ולא האתר שלך. HostingEnvironment.MapPath ממיר נתיב יחסי לאתר לנתיב מלא:

csharp
Doconut.DoconutHost.Initialize(options =>
{
    options.LicensePath = HostingEnvironment.MapPath("~/wwwroot/Doconut.Viewer.lic");
});

אם הקובץ אינו קיים, Doconut לא זורק חריגה ולא חוזר לגילוי אוטומטי: הוא לא טוען רישיון, והצופה מציג סימני מים. קבצי הרישיון לכל תוסף באותה תיקייה (Doconut.Viewer.<Capability>.lic) נקראים יחד איתו, ולכן LicensePath ו‑AddPlugin<...>() פועלים יחד כאשר רישיונות התוספים נמצאים לצד רישיון הבסיס.

לפי זרם

LicenseStream נקרא פעם אחת, בעת האתחול — שימושי כאשר הרישיון מגיע ממשאב משובץ או מחנות סודית במקום קובץ על הדיסק.

csharp
// קדימות: LicenseStream > LicenseContent > LicensePath > חיפוש אוטומטי.
Doconut.DoconutHost.Initialize(options =>
{
    options.LicenseStream = licenseStream;
});

לפי תוכן

LicenseContent מקבל את טקסט הרישיון עצמו — ממשתנה סביבתי, ממסד נתונים, או מחנות סודית — ולכן אין צורך לפרוס קובץ רישיון עם האתר.

csharp
// קובץ XML של רישיון ממסד נתונים, משתנה סביבתי או מחסן סודות -
// אין קובץ על הדיסק. רק LicenseStream מתעלה עליו.
Doconut.DoconutHost.Initialize(options =>
{
    options.LicenseContent = Environment.GetEnvironmentVariable("DOCONUT_LICENSE") ?? "";
});

גילוי אוטומטי

אל תגדיר אף אחד משלושת האפשרויות, ו‑Doconut יחפש את הרישיון בעצמו:

csharp
// אל תגדיר דבר, ו‑Doconut יחפש את הרישיון בעצמו, לפי הסדר הבא:
//   1. {CurrentDirectory}\wwwroot
//   2. {AppContext.BaseDirectory}\wwwroot   (תחת IIS: תיקיית השורש של האתר)
// הוא מחפש תחילה את Doconut.lic; אם הוא חסר, אז Doconut.Viewer.lic ועוד
// קבצי Doconut.Viewer.<Capability>.lic לכל תוסף.
Doconut.DoconutHost.Initialize();

שתי התיקיות, לפי סדר, והקבצים שמחפשים:

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-plugin licenses, read only when Doconut.Viewer.lic was found

ב‑IIS וב‑IIS Express, AppContext.BaseDirectory הוא תיקיית השורש של האתר — התיקייה שמכילה את Web.config — ולא תיקיית bin שלו. לכן הרישיון צריך להיות בwwwroot תחת שורש האתר:

text
MySite\
  Web.config
  Global.asax
  bin\
  wwwroot\
    Doconut.Viewer.lic
    Doconut.Viewer.Converter.lic

בפרויקט, שמור את wwwroot\*.lic ליד Web.config ופרוס את התיקייה עם האתר. אין צורך שלב בנייה שיתעתק אותו לשום מקום. .lic במיקום אחר — בbin\, ליד Web.config, או בתת‑תיקייה של wwwroot — לעולם לא נקרא.

שמור קבצי .lic מחוץ לבקרת גרסאות. פרוס אותם לצד האתר, או ספק את הרישיון דרך LicenseContent או LicenseStream מהחנות הסודית שלך.

מה קורה ללא רישיון

חוסר רישיון אינו גורם לשגיאה. DoconutHost.Initialize מצליח, האתר מתחיל, והצופה פועל, אך כל דף מציג סימן מים של הערכה ואין שום יכולת אופציונלית המוענקת.

קובץ רישיון שנמצא אך נדחה הוא שונה. חתימה לא תקפה, שינוי, או בנייה מחוץ לחלון הגרסה של הרישיון גורמים לOpenDocumentAsync לזרוק LicenseException עם הסיבה. רישיון זמני שפג תוקפו ממשיך במצב סימן מים. רישיון בתשלום שהתאריך המנוי שלו עבר ממשיך לעבוד, נקי ועם היכולות שלו, על כל בנייה שפורסמה לפני תאריך זה.

תוספים זקוקים לרישיון שלהם בעת ההפעלה

רישום תוסף שהיכולת שלו אינה ניתנת על ידי רישיון עוצר את היישום בעת ההפעלה. DoconutHost.Initialize זורק בApplication_Start:

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.

ב‑System.Web, אינך רואה את ההודעה הזאת בדפדפן. כל בקשה לאתר משיבה 500 ריק — ללא דף שגיאה, ללא עקבות מחסנית, ללא דבר ביומן IIS. החריגה נרשמת רק ביומן אירועי Windows (יומן יישום, מקור ASP.NET). אם כל האתר מפסיק להגיב מיד אחרי שהוספת שורת AddPlugin, בדוק את קבצי הרישיון בwwwroot לפני הקוד: הDoconut.Viewer.<Capability>.lic של התוסף צריך להיות ליד Doconut.Viewer.lic, וללא רישיון בסיסי קבצי התוסף אינם נקראים כלל.

אמת את הרישיון הטעון

IDoconutLicenseService הוא אותו מקור אמת שה‑SDK משתמש בו. פתר אותו מDoconutHost.Services כדי לחשוף נקודת קצה אבחונית מאומתת או לנהל דגלי תכונה — לעולם אל תחזיר את תוכן הרישיון:

csharp
// GET /License/Status
public ActionResult Status()
{
    var license = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();

    return Json(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
    }, JsonRequestBehavior.AllowGet);
}

הרישיון נקרא פעם אחת, בDoconutHost.Initialize. לאחר החלפת קובץ רישיון, מחזיר את בריכת היישומים (או משגע את Web.config) כך שApplication_Start ירוץ שוב.

פתרון בעיות

תסמיןסיבה משוערתבדיקה
הצופה עובד אך כל דף מסומן במיםלא נמצא רישיוןהאם .lic ב<site root>\wwwroot? קרא את נקודת הקצה של הסטטוס למעלה
כל בקשה משיבה 500 ריק מיד אחרי הוספת תוסףתוסף רשום אין לו רישיון המעניק לויומן אירועי Windows, מקור ASP.NET; ה.lic של התוסף ליד Doconut.Viewer.lic
LicensePath עובד במכונה שלך אך לא בשרתנתיב יחסי שנפתר ביחס לתיקיית תהליך העובדבנה זאת עם HostingEnvironment.MapPath("~/wwwroot/...")
קובץ .lic שהוחלף אינו משפיעהרישיון נקרא כאשר היישום התחילהחזר את בריכת היישומים
OpenDocumentAsync זורק LicenseExceptionהרישיון נמצא אך נדחהקרא את הודעת החריגה; אל תציג אותה ללקוחות לא מהימנים

צעדים הבאים

  • Licensing — יכולות, וכיצד לבדוק אותן בזמן ריצה.
  • Troubleshooting — סימני מים, כשלי הפעלה, ותסמינים אחרים.

האם דף זה היה מועיל?