Αδειοδότηση

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

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

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

ΚατάστασηΑνοίγει έγγραφα;ΥδατογράφημαΔυνατότητες
Πλήρης (πληρωμένη) άδεια (αυτή η έκδοση κυκλοφόρησε πριν από την ημερομηνία συνδρομής της)ΝαιΚανέναΟι αγορασμένες (Has* flags)
Προσωρινή άδεια (Developer/NFR — η άδεια αξιολόγησης, πριν από την ημερομηνία λήξης της)ΝαιΚανένα στον βασικό προβολέα· η έξοδος του plugin είναι υδατογραφημένηΌλα — γενική χορήγηση (το κανάλι αξιολόγησης)
Ληγμένη προσωρινή άδεια (πέρα από την ημερομηνία LicenseExpiry της)ΝαιΥδατογράφημα αξιολόγησηςΚαμία χορηγία
Καμία άδειαΝαιΥδατογράφημα αξιολόγησηςΚαμία χορηγία
Βρέθηκε αλλά απορρίφθηκε (μη έγκυρη υπογραφή, παραποιημένο, σε μαύρη λίστα, ή έκδοση που κυκλοφόρησε μετά από την ημερομηνία συνδρομής της άδειας)Όχι — LicenseException σε κάθε άνοιγμα——

Μια πληρωμένη άδεια της οποίας η ημερομηνία συνδρομής έχει περάσει συνεχίζει να λειτουργεί — καθαρά, με τις δυνατότητές της — σε κάθε έκδοση που κυκλοφόρησε πριν από αυτήν την ημερομηνία. Μόνο μια έκδοση που κυκλοφορήσει μετά αυτήν απορρίπτεται.

Δύο συνέπειες που αξίζει να εσωτερικοποιήσετε:

  • Ένα ελλιπές αρχείο άδειας δεν είναι προσωρινή άδεια. Χωρίς αρχείο άδειας, οι σελίδες εμφανίζονται με υδατογράφημα και καμία δυνατότητα (αναζήτηση, σχολιασμός, plugins) δεν είναι ενεργή. Η πλήρης, χωρίς υδατογράφημα εμπειρία απαιτεί μια πραγματική Προσωρινή άδεια (αποκτήστε μία).
  • Μόνο μια απορριφθείσα άδεια εμποδίζει το άνοιγμα. Μια ληγμένη Προσωρινή άδεια διατηρεί την εφαρμογή σε λειτουργία με το υδατογράφημα αξιολόγησης, και μια πληρωμένη άδεια που έχει περάσει την ημερομηνία συνδρομής της συνεχίζει να εμφανίζει καθαρά τις εκδόσεις που καλύπτει· όμως η ανάπτυξη μιας έκδοσης που κυκλοφόρησε μετά την ημερομηνία συνδρομής της άδειας απορρίπτεται και αποτυγχάνει άμεσα με ένα LicenseException, έτσι το εντοπίζετε κατά την ανάπτυξη — όχι με σιωπηλή αποστολή εξόδου με υδατογράφημα. Η εξαίρεση (από OpenDocumentAsync) μεταφέρει τον λόγο από License.RejectionMessage.

Δυνατότητες

Το Doconut ελέγχει την προαιρετική λειτουργικότητα μέσω δυνατότητας. Καλύπτει τις ενσωματωμένες λειτουργίες Αναζήτηση και Σχόλιο και τα plugins Converter, Dicom και Signer που μπορούν να ενεργοποιηθούν, καθεμία χορηγείται από την άδειά σας. Ο βασικός προβολέας δεν είναι δυνατότητα — είναι η προαπαιτούμενη, εμφανιζόμενη ως IsViewerLicensed:

csharp
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // non-TRIAL άδεια παρούσα ΚΑΙ καλύπτει την έκδοση αυτού του 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 εκθέτει το φιλικό προς την εμφάνιση στιγμιότυπο για πίνακες διαχειριστών: 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() να φορτώσει τη νέα άδεια.

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