Αδειοδότηση

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

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

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

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

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

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

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

Δυνατότητες

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

csharp
var lic = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // non-TRIAL άδεια υπάρχει ΚΑΙ καλύπτει την έκδοση αυτής της κατασκευής

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

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

Η λογική του, ακριβώς όπως στην υλοποίηση: μια ενεργή (μη ληγμένη) Προσωρινή άδεια χορηγεί κάθε δυνατότητα — συμπεριλαμβανομένων των δυνατοτήτων που δεν έχουν ακόμη ειδική σημαία αγοράς· μια πραγματική αγορασμένη άδεια χορηγεί ακριβώς τις σημαίες Has* της και είναι προεπιλογή-απόρριψη για οτιδήποτε μη αντιστοιχισμένο. (Ένα παλιό αρχείο τύπου ΔΟΚΙΜΗ δεν αποτελεί δικαίωμα — αντιμετωπίζεται ως χωρίς άδεια: υδατογραφημένο, καμία χορηγία.)

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

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

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

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

Αναφορά IDoconutLicenseService

Επιλύστε IDoconutLicenseService (namespace Doconut.Core.Interfaces) από DoconutHost.Services. Είναι singleton — η άδεια αναλύεται μία φορά, στο DoconutHost.Initialize:

ΜέλοςΣημασία
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
// GET /Features - feature-flag το UI σας από την ίδια πηγή αλήθειας που χρησιμοποιεί το SDK
public ActionResult Index()
{
    var lic = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();

    return Json(new
    {
        viewer     = lic.IsViewerLicensed || lic.IsTemporary,
        search     = lic.IsCapabilityGranted(LicenseCapability.Search),
        annotation = lic.IsCapabilityGranted(LicenseCapability.Annotation),
        conversion = lic.HasConverter,
        dicom      = lic.HasDicom,
    }, JsonRequestBehavior.AllowGet);
}

Έλεγχος υγείας

Doconut καταχωρεί έναν "doconut" έλεγχο υγείας που αναφέρει την κατάσταση της άδειας. Το Classic ASP.NET δεν διαθέτει δικό του endpoint υγείας, έτσι εκθέστε το από έναν ελεγκτή:

csharp
// GET /Health - Doconut καταχωρεί έναν "doconut" έλεγχο υγείας που αναφέρει την κατάσταση της άδειας:
// Υγιής (έγκυρη), Υποβαθμισμένη (δοκιμαστική ή χωρίς αρχείο άδειας), Μη υγιής (απορριφθείσα ή ληγμένη).
public async Task<ActionResult> Index()
{
    var health = Doconut.DoconutHost.Services.GetRequiredService<HealthCheckService>();
    HealthReport report = await health.CheckHealthAsync();

    Response.StatusCode = report.Status == HealthStatus.Unhealthy ? 503 : 200;
    return Content(report.Status.ToString(), "text/plain");
}

Συνδέστε το στην παρακολούθησή σας και μια λήγουσα συνδρομή γίνεται ειδοποίηση αντί για αίτημα υποστήριξης. Ο έλεγχος αναφέρει Unhealthy όταν η άδεια απορρίπτεται ή όταν IsExpired είναι αληθές· για μια πληρωμένη άδεια, αυτό σημαίνει ότι η ημερομηνία λήξης της συνδρομής έχει περάσει και ένα πακέτο που κυκλοφορεί μετά θα απορριφθεί — η τρέχουσα έκδοση παραμένει καθαρή. Δείτε το DoconutHost για τις τιμές κατάστασης.

Αναβαθμίσεις έκδοσης

Μια άδεια καλύπτει ένα παράθυρο έκδοσης. Η ενημέρωση του πακέτου NuGet σε μια έκδοση νεότερη από εκείνο το παράθυρο καθιστά την άδεια άκυρη για αυτήν την έκδοση: IsVersionValid μετατρέπει false και το άνοιγμα αποκλείεται με ένα LicenseException (ο λόγος βρίσκεται στο License.RejectionMessage) — σκόπιμα fail-fast, ώστε μια παλιά ή μη αδειοδοτημένη έκδοση να εντοπίζεται κατά την ανάπτυξη αντί να προσθέτει σιωπηλά υδατογράφημα στην παραγωγική έξοδο. Ανανεώστε τη συνδρομή, αντικαταστήστε το .lic στο wwwroot, και επαναλάβετε την κυκλοφορία της πισίνας εφαρμογών ώστε το DoconutHost.Initialize φορτώνει τη νέα άδεια.

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