רישוי
יכולות, רמות רישיון ושירות הרישיון
דף זה הוא ההתייחסות בזמן ריצה לאופן שבו רישיון מעצב את ההתנהגות של Doconut: מה כל מצב רישיון מאפשר, איך ניתנות היכולות, ואיך לבדוק את כל זה מהקוד. (לטעינת רישיון, ראו ההתחלה → הגדרת רישיון.)
מצבי רישיון ומה הם עושים
| מצב | פותח מסמכים? | סימן מים | יכולות |
|---|---|---|---|
| רישיון מלא (בתשלום) (גרסה זו שוחררה לפני תאריך המנוי שלה) | כן | אין | הדגלים שנרכשו (Has* flags) |
| רישיון זמני (מפתח/NFR — רישיון ההערכה, לפני תאריך הפקיעה) | כן | אין על הצופה הבסיסי; פלט תוסף מסומן במים | הכול — מתן כולל (תהליך ההערכה) |
רישיון זמני פג תוקף (עבר תאריך LicenseExpiry שלו) | כן | סימן מים של הערכה | לא ניתנה שום |
| אין קובץ רישיון כלל | כן | סימן מים של הערכה | לא ניתנה שום |
| נמצא אך נדחה (חתימה לא תקפה, שונה, ברשימה שחורה, או גרסה שוחררה אחרי תאריך המנוי של הרישיון) | לא — LicenseException בכל פתיחה | — | — |
רישיון בתשלום שהיום עבר תאריך המנוי שלו ממשיך לעבוד — ללא סימן מים, עם היכולות שלו — על כל גרסה שוחררה לפני תאריך זה. רק גרסה שוחררה אחרי תאריך המנוי נדחית.
שתי תוצאות שכדאי להטמיע:
- חוסר רישיון אינו רישיון זמני. ללא קובץ רישיון, הדפים מוצגים עם סימן מים ואין שום יכולת (חיפוש, הערה, תוספים) פעילה. החוויה המלאה, ללא סימן מים, דורשת רישיון זמני (קבל אחד).
- רק רישיון שנדחה חוסם פתיחה. רישיון זמני שפג משאיר את האפליקציה פועלת עם סימן מים של הערכה, ורישיון בתשלום שעבר את תאריך המנוי שלו ממשיך להציג ללא סימן מים על הגרסאות שהוא מכסה; אך פריסת גרסה שפורסמה אחרי תאריך המנוי של הרישיון נדחית ונכשלת מיידית עם
LicenseException, כך שאתה תופס זאת בפריסה — ולא על ידי שליחת פלט עם סימן מים בשקט. החריגה ההיא (מOpenDocumentAsync) נושאת את הסיבה מLicense.RejectionMessage.
יכולות
Doconut מגביל פונקציונליות אופציונלית באמצעות יכולת. זה כולל את תכונות חיפוש והערה המובנות ואת התוספים Converter, Dicom וSigner שניתן לבחור בהם, שכל אחד ניתנת לפי הרישיון שלך. הצופה הבסיסי אינו יכולת — הוא דרישה מוקדמת, מוצג כIsViewerLicensed:
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // רישיון non-TRIAL קיים AND מכסה את גרסת הבנייה הזוהשער היחיד שהצינור כולו משתמש בו הוא IsCapabilityGranted:
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool searchGranted = lic.IsCapabilityGranted(LicenseCapability.Search);ההיגיון שלו, במדויק מהיישום: רישיון זמני פעיל (שאינו פג תוקף) מעניק כל היכולת — כולל יכולות שאין להן עדיין דגל רכישה ייעודי; רישיון שנרכש במציאות מעניק בדיוק את דגלי Has* שלו והוא דחיית ברירת מחדל לכל דבר שלא ממופה. (קובץ מסוג TRIAL מורשת הוא לא זכות — הוא מתייחס כלא מורשה: מסומן במים, שום דבר לא ניתנת.)
רישיונות זמניים
רישיונות זמניים (מפתח/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.
// 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:
app.MapHealthChecks("/health");חבר זאת למערכת המעקב שלך והסבסוד המתקרב לפקיעה הופך להתראה במקום פנייה לתמיכה. הבדיקה מדווחת Unhealthy כאשר הרישיון נדחה או כאשר IsExpired הוא אמת; עבור רישיון בתשלום, משמעות הדבר שתאריך המנוי עבר וחבילה שפורסמה אחרי תאריך זה תידחה — הגרסה הנוכחית ממשיכה להציג ללא סימן מים.
עדכוני גרסה
רישיון מכסה חלון גרסה. עדכון חבילת NuGet לגרסה חדשה יותר מהחלון הופך את הרישיון ללא תקף עבור גרסה זו: IsVersionValid משנה את false והפתיחה חסומה עם LicenseException (הסיבה נמצאת בLicense.RejectionMessage) — כוונה לכשל מיידי, כך שגרסה ישנה או לא מורשית נתפסת בפריסה במקום לסמן במים את הפלט של הייצור בשקט. חידוש המנוי, החלפת .lic, והפעלת האפליקציה מחדש כך שAddDoconut() טוען את הרישיון החדש.
האם דף זה היה מועיל?