Αδειοδότηση
Δυνατότητες, επίπεδα αδειών και η υπηρεσία αδειών
Αυτή η σελίδα είναι η αναφορά χρόνου εκτέλεσης για το πώς μια άδεια διαμορφώνει τη συμπεριφορά του Doconut: τι επιτρέπει κάθε κατάσταση άδειας, πώς χορηγούνται οι δυνατότητες, και πώς να τις ελέγξετε από τον κώδικα. (Για φόρτωση μιας άδειας, δείτε το Ξεκινώντας → Ρύθμιση άδειας.)
Καταστάσεις άδειας και τι κάνουν
| Κατάσταση | Ανοίγει έγγραφα; | Υδατογράφημα | Δυνατότητες |
|---|---|---|---|
| Πλήρης (πληρωμένη) άδεια (αυτή η έκδοση κυκλοφόρησε πριν από την ημερομηνία συνδρομής της) | Ναι | Κανένα | Οι αγορασμένες (Has* flags) |
| Προσωρινή άδεια (Developer/NFR — η άδεια αξιολόγησης, πριν από την ημερομηνία λήξης της) | Ναι | Κανένα στον βασικό προβολέα· η έξοδος του plugin είναι υδατογραφημένη | Όλα — γενική χορήγηση (το κανάλι αξιολόγησης) |
Ληγμένη προσωρινή άδεια (πέρα από την ημερομηνία LicenseExpiry της) | Ναι | Υδατογράφημα αξιολόγησης | Καμία χορηγία |
| Καμία άδεια | Ναι | Υδατογράφημα αξιολόγησης | Καμία χορηγία |
| Βρέθηκε αλλά απορρίφθηκε (μη έγκυρη υπογραφή, παραποιημένο, σε μαύρη λίστα, ή έκδοση που κυκλοφόρησε μετά από την ημερομηνία συνδρομής της άδειας) | Όχι — LicenseException σε κάθε άνοιγμα | — | — |
Μια πληρωμένη άδεια της οποίας η ημερομηνία συνδρομής έχει περάσει συνεχίζει να λειτουργεί — καθαρά, με τις δυνατότητές της — σε κάθε έκδοση που κυκλοφόρησε πριν από αυτήν την ημερομηνία. Μόνο μια έκδοση που κυκλοφορήσει μετά αυτήν απορρίπτεται.
Δύο συνέπειες που αξίζει να εσωτερικοποιήσετε:
- Ένα ελλιπές αρχείο άδειας δεν είναι προσωρινή άδεια. Χωρίς αρχείο άδειας, οι σελίδες εμφανίζονται με υδατογράφημα και καμία δυνατότητα (αναζήτηση, σχολιασμός, plugins) δεν είναι ενεργή. Η πλήρης, χωρίς υδατογράφημα εμπειρία απαιτεί μια πραγματική Προσωρινή άδεια (αποκτήστε μία).
- Μόνο μια απορριφθείσα άδεια εμποδίζει το άνοιγμα. Μια ληγμένη Προσωρινή άδεια διατηρεί την εφαρμογή σε λειτουργία με το υδατογράφημα αξιολόγησης, και μια πληρωμένη άδεια που έχει περάσει την ημερομηνία συνδρομής της συνεχίζει να εμφανίζει καθαρά τις εκδόσεις που καλύπτει· όμως η ανάπτυξη μιας έκδοσης που κυκλοφόρησε μετά την ημερομηνία συνδρομής της άδειας απορρίπτεται και αποτυγχάνει άμεσα με ένα
LicenseException, έτσι το εντοπίζετε κατά την ανάπτυξη — όχι με σιωπηλή αποστολή εξόδου με υδατογράφημα. Η εξαίρεση (απόOpenDocumentAsync) μεταφέρει τον λόγο απόLicense.RejectionMessage.
Δυνατότητες
Το Doconut ελέγχει την προαιρετική λειτουργικότητα μέσω δυνατότητας. Καλύπτει τις ενσωματωμένες λειτουργίες Αναζήτηση και Σχόλιο και τα plugins Converter, Dicom και Signer που μπορούν να ενεργοποιηθούν, καθεμία χορηγείται από την άδειά σας. Ο βασικός προβολέας δεν είναι δυνατότητα — είναι η προαπαιτούμενη, εμφανιζόμενη ως IsViewerLicensed:
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // non-TRIAL άδεια παρούσα ΚΑΙ καλύπτει την έκδοση αυτού του buildΗ μοναδική πύλη που χρησιμοποιεί ολόκληρη η αλυσίδα επεξεργασίας είναι IsCapabilityGranted:
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.
// 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() να φορτώσει τη νέα άδεια.
Ήταν αυτή η σελίδα χρήσιμη;