רישוי

יכולות, רמות רישיון, ושירות הרישיון

דף זה הוא ההתייחסות בזמן ריצה לאופן שבו רישיון מעצב את ההתנהגות של Doconut: מה כל מצב רישיון מאפשר, איך ניתנות היכולות, ואיך לבדוק את כל זה מהקוד. (לטעינת רישיון, ראה הגדרת רישיון.)

מצבי רישיון ומה הם עושים

מצבפותח מסמכים?סימן מיםיכולות
רישיון מלא (בתשלום) (הגרסה הזו שוחררה לפני תאריך המנוי שלה)כןאיןהדגלים שנרכשו (Has*)
רישיון זמני (מפתח/לא למכירה — רישיון הערכה, לפני תאריך הפקיעה)כןאין על הצופה הבסיסי; פלט תוספים מסומן במיםהכל — מתן רישיון כולל (משפך ההערכה)
רישיון זמני שפג (אחרי תאריך LicenseExpiry שלו)כןסימן מים של הערכהאין שום רישיון
אין קובץ רישיון כללכןסימן מים של הערכהאין שום רישיון
נמצא אך נדחה (חתימה לא תקפה, שונה, ברשימה שחורה, או גרסה שפורסמה אחרי תאריך המנוי של הרישיון)לא — LicenseException בכל פתיחה——

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

שתי תוצאות שכדאי להטמיע:

  • חוסר רישיון אינו רישיון זמני. ללא קובץ רישיון, הדפים מוצגים עם סימן מים ואין שום יכולת (חיפוש, הערה, תוספים) פעילה. החוויה המלאה ללא סימן מים דורשת רישיון זמני (קבל אחד).
  • רק רישיון שנדחה חוסם פתיחה. רישיון זמני שפג משאיר את האפליקציה פועלת עם סימן מים של הערכה, ורישיון בתשלום אחרי תאריך המנוי שלו משאיר את ההצגה נקייה על הגרסאות שהוא מכסה; אך פריסת גרסה שפורסמה אחרי תאריך המנוי של הרישיון נדחית ונכשלת מיידית עם LicenseException, כך שאתה תופס זאת בפריסה — ולא על ידי שליחת פלט מסומן במים בשקט. החריגה (מOpenDocumentAsync) נושאת את הסיבה מLicense.RejectionMessage.

יכולות

Doconut מגביל פונקציונליות אופציונלית באמצעות יכולת. זה כולל את תכונות החיפוש והההערה המובנות ותוספי Converter, Dicom ו-Signer שניתן לבחור, שכל אחד מהם מוענק על ידי הרישיון שלך. הצופה הבסיסי אינו יכולת — הוא דרישה מוקדמת, מוצג כIsViewerLicensed:

csharp
var lic = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // רישיון non-TRIAL קיים ומכסה את גרסת הבנייה הזו

השער היחיד שהצינור כולו משתמש בו הוא IsCapabilityGranted:

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

ההיגיון שלו, במילה במילה מהיישום: רישיון זמני פעיל (לא פג) מעניק כל היכולת — כולל יכולות שאין להן עדיין דגל רכישה ייעודי; רישיון שנרכש במלואו מעניק בדיוק את דגלי Has* שלו והוא דיפולט-דחייה לכל דבר שלא ממופה. (קובץ מסוג TRIAL מדור קודם אינו זכות — הוא מתייחס כלא מורשה: מסומן במים, אין שום רישיון.)

רישיונות זמניים

רישיונות זמניים (מפתח/לא למכירה) מסומנים בתג ExpiryNote ונושאים תאריך פקיעה קפדני:

חברמשמעות
IsTemporaryתג ExpiryNote קיים (הזיהוי מתבצע על ידי נוכחות התג — לעולם לא תואם לטקסט ההערה, הוא דינמי)
ExpiryNoteטקסט מידע משובץ ברישיון
LicenseExpiryתאריך פקיעה קפדני (DateTime?)

המשמעות של פקיעה שונה לפי רמה: רישיון זמני פג בתאריך LicenseExpiry בלבד (חלון המנוי שלו מתעלמים ממנו; רישיון זמני ללא תאריך מתייחס כפקוע, בטוח). כל רישיון אחר פוג בתאריך חלון המנוי/עדכון שלו; עבור רישיון בתשלום, IsExpired מדווח רק שהתאריך עבר — גרסאות שפורסמו לפניו נשארות נקיות ושומרות על היכולות שלהן.

IDoconutLicenseService רפרנס

פתור את IDoconutLicenseService (מרחב שמות Doconut.Core.Interfaces) מDoconutHost.Services. זהו singleton — הרישיון מפוענח פעם אחת, בDoconutHost.Initialize:

חברמשמעות
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דגל אחד לכל יכולת: נרכש ברישיון המכסה בנייה זו, או ניתן על‑ידי רישיון זמני פעיל. IsCapabilityGranted עונה על אותה שאלה לפי יכולת
IsValidForDomain(host)כיסוי מארח; רישיונות V4 משתמשים בתו הכללי *.*
LicenseRejectionReasonלא‑ריק ⇒ פתיחה נחסמת עם הודעה זו

DoconutLicenseInfo חושף את צילום המצב הידידותי לממשק ניהול: Owner, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, דגלי Has*, שדות הרישיון הזמניים, ו‑RejectionMessage.

csharp
// GET /Features - feature-flag הממשק שלך מאותו מקור אמת שה‑SDK משתמש בו
public ActionResult Index()
{
    var lic = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();

    return Json(new
    {
        viewer     = lic.IsViewerLicensed || lic.IsTemporary,
        search     = lic.IsCapabilityGranted(LicenseCapability.Search),
        annotation = lic.IsCapabilityGranted(LicenseCapability.Annotation),
        conversion = lic.HasConverter,
        dicom      = lic.HasDicom,
    }, JsonRequestBehavior.AllowGet);
}

בדיקת בריאות

Doconut רושמת בדיקת בריאות מסוג "doconut" המדווחת על מצב הרישיון. ל‑Classic ASP.NET אין נקודת קצה לבריאות משלה, ולכן יש לחשוף אותה מבקר:

csharp
// GET /Health - Doconut רושמת "doconut" בדיקת בריאות המדווחת על מצב הרישיון:
// Healthy (תקף), Degraded (נסיון או ללא קובץ רישיון), Unhealthy (נדחה או פג תוקף).
public async Task<ActionResult> Index()
{
    var health = Doconut.DoconutHost.Services.GetRequiredService<HealthCheckService>();
    HealthReport report = await health.CheckHealthAsync();

    Response.StatusCode = report.Status == HealthStatus.Unhealthy ? 503 : 200;
    return Content(report.Status.ToString(), "text/plain");
}

חבר זאת למערכת המעקב שלך והסיום של מנוי מתקרב הופך להתראה במקום לקריאת תמיכה. הבדיקה מדווחת Unhealthy כאשר הרישיון נדחה או כאשר IsExpired הוא אמת; עבור רישיון בתשלום, משמעות הדבר היא שתאריך המנוי עבר וחבילה שהוצאה לאחריו תידחה — הבנייה הנוכחית ממשיכה לרנדר בצורה נקייה. ראה את DoconutHost לערכי המצב.

שדרוגי גרסה

רישיון מכסה חלון גרסה. עדכון חבילת ה‑NuGet לבנייה חדשה יותר מהחלון הופך את הרישיון ללא תקף עבור בנייה זו: IsVersionValid הופך ל‑false ופתיחה נחסמת עם LicenseException (הסיבה נמצאת ב‑License.RejectionMessage) — כשלון מהיר בכוונה, כך שבנייה ישנה או לא מורשית נתפסת בזמן הפריסה ולא משאירה סימן מים שקט בפלט הייצור. חידש את המנוי, החלף את .lic בwwwroot, והפעל מחדש את מאגר האפליקציות כדי שDoconutHost.Initialize יטען את הרישיון החדש.

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