רישוי

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

דף זה הוא ההתייחסות בזמן ריצה לאופן שבו רישיון מעצב את ההתנהגות של 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 רישיון קיים AND מכסה את גרסת הבנייה הזו

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

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