רישוי

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

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

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

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

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

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

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

יכולות

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

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

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

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

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

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

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

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

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

הפנייה ל‑IDoconutLicenseService

הזרק IDoconutLicenseService (מרחב שם Doconut.Core.Interfaces; רשום כסינגלטון — הרישיון מפוענח פעם אחת בהפעלה):

חברמשמעות
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
// 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() יטען את הרישיון החדש.

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