Αδειοδότηση

Δυνατότητες, επίπεδα αδειών και η υπηρεσία αδειών

Αυτή η σελίδα είναι η αναφορά χρόνου εκτέλεσης για το πώς μια άδεια διαμορφώνει τη συμπεριφορά του Doconut: τι επιτρέπει κάθε κατάσταση άδειας, πώς χορηγούνται οι δυνατότητες και πώς να τις ελέγξετε όλο από τον κώδικα. (Για φόρτωση μιας άδειας, δείτε Ξεκινώντας → Ρύθμιση άδειας.)

Καταστάσεις άδειας και τι κάνουν

ΚατάστασηΑνοίγει έγγραφα;ΥδατογράφημαΔυνατότητες
Πλήρης (πληρωμένη) άδεια (αυτή η έκδοση κυκλοφόρησε πριν από την ημερομηνία συνδρομής)ΝαιΚανέναΟι αγορασμένες (Has* flags)
Προσωρινή άδεια (Developer/NFR — η άδεια αξιολόγησης, πριν από την ημερομηνία λήξης)ΝαιΚανένα στον βασικό προβολέα· η έξοδος του plugin είναι υδατογραφημένηΌλα — γενική χορήγηση (το κανάλι αξιολόγησης)
Ληγμένη προσωρινή άδεια (πέρα από την ημερομηνία 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 καλύπτει την έκδοση αυτού του build

Η μοναδική πύλη που χρησιμοποιεί ολόκληρη η αλυσίδα είναι IsCapabilityGranted:

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

Η λογική του, ακριβώς όπως στην υλοποίηση: μια ενεργή (μη ληγμένη) Προσωρινή άδεια χορηγεί κάθε δυνατότητα — συμπεριλαμβανομένων των δυνατοτήτων που δεν έχουν ακόμη ειδική σημαία αγοράς· μια πραγματική αγορασμένη άδεια χορηγεί ακριβώς τις σημαίες Has* της και είναι default‑deny για οτιδήποτε δεν αντιστοιχεί. (Ένα κληρονομικό αρχείο τύπου TRIAL δεν είναι δικαίωμα — αντιμετωπίζεται ως χωρίς άδεια: υδατογραφημένο, καμία χορηγία.)

Προσωρινές άδειες

Οι προσωρινές (Developer/NFR) άδειες σημειώνονται με μια ετικέτα ExpiryNote και έχουν σκληρή ημερομηνία λήξης:

ΜέλοςΣημασία
IsTemporaryΜια ετικέτα ExpiryNote υπάρχει (η ανίχνευση γίνεται με την παρουσία της ετικέτας — ποτέ δεν ταιριάζει με το κείμενο της σημείωσης, είναι δυναμική)
ExpiryNoteΠληροφοριακό κείμενο ενσωματωμένο στην άδεια
LicenseExpiryΗ σκληρή ημερομηνία λήξης (DateTime?)

Η σημασιολογία λήξης διαφέρει ανά επίπεδο: μια προσωρινή άδεια λήγει στην ημερομηνία LicenseExpiry μόνο (το παράθυρο συνδρομής αγνοείται· μια προσωρινή άδεια χωρίς ημερομηνία θεωρείται ληγμένη, ασφαλής). Κάθε άλλη άδεια λήγει στην ημερομηνία συνδρομής/ενημέρωσης· για μια πληρωμένη άδεια, το IsExpired αναφέρει μόνο ότι αυτή η ημερομηνία έχει περάσει — οι εκδόσεις που κυκλοφόρησαν πριν παραμένουν καθαρές και διατηρούν τις δυνατότητές τους.

Αναφορά IDoconutLicenseService

Ενσωματώστε το IDoconutLicenseService (namespace Doconut.Core.Interfaces; καταχωρημένο ως singleton — η άδεια αναλύεται μία φορά κατά την εκκίνηση):

ΜέλοςΣημασία
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 εκθέτει το φιλικό προς την εμφάνιση στιγμιότυπο για τα admin panels: 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() φορτώνει τη νέα άδεια.

Ήταν αυτή η σελίδα χρήσιμη;