Ρύθμιση Άδειας

Πού ψάχνει το Doconut για το αρχείο άδειας σας κάτω από το IIS

Χωρίς άδεια, το Doconut εξακολουθεί να αποδίδει έγγραφα — κάθε σελίδα φέρει μόνο ένα υδατογράφημα αξιολόγησης. Αυτή η σελίδα καλύπτει τους τέσσερις τρόπους παροχής άδειας στο Global.asax, πού ψάχνει το Doconut όταν δεν παρέχετε καμία, και τι συμβαίνει όταν λείπει η άδεια ενός πρόσθετου.

Τέσσερις τρόποι παροχής άδειας

Υπάρχουν τρεις σαφείς πηγές στο DoconutOptions — διαδρομή αρχείου, ροή ή ακατέργαστο περιεχόμενο — συν αυτόματη ανίχνευση όταν καμία δεν έχει οριστεί. Όλες διαβάζονται μία φορά, στο DoconutHost.Initialize. Όταν ορίζονται περισσότερες από μία, η προτεραιότητα είναι ακριβής:

LicenseStream υπερισχύει του LicenseContent, υπερισχύει του LicensePath, υπερισχύει της αυτόματης ανίχνευσης.

Με διαδρομή

Δώστε στο LicensePath μια πλήρη διαδρομή. Μια σχετική διαδρομή επιλύεται σε σχέση με τον τρέχοντα φάκελο της διεργασίας, και κάτω από το IIS αυτός είναι ο φάκελος της διεργασίας εργαζόμενου, όχι του ιστότοπού σας. Το HostingEnvironment.MapPath μετατρέπει μια διαδρομή σχετική με τον ιστότοπο σε πλήρη:

csharp
Doconut.DoconutHost.Initialize(options =>
{
    options.LicensePath = HostingEnvironment.MapPath("~/wwwroot/Doconut.Viewer.lic");
});

Αν το αρχείο δεν υπάρχει, το Doconut δεν πετάει εξαίρεση και δεν επιστρέφει στην αυτόματη ανίχνευση: δεν φορτώνει άδεια, και ο προβολέας προσθέτει υδατογραφήματα. Τα αρχεία άδειας ανά πρόσθετο στον ίδιο φάκελο (Doconut.Viewer.<Capability>.lic) διαβάζονται μαζί του, έτσι τα LicensePath και AddPlugin<...>() λειτουργούν μαζί όταν οι άδειες των πρόσθετων βρίσκονται δίπλα στην κύρια άδεια.

Με ροή

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

csharp
// Προτεραιότητα: LicenseStream > LicenseContent > LicensePath > αυτόματη αναζήτηση.
Doconut.DoconutHost.Initialize(options =>
{
    options.LicenseStream = licenseStream;
});

Με περιεχόμενο

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

csharp
// License XML από μια βάση δεδομένων, μια μεταβλητή περιβάλλοντος ή ένα κατάστημα μυστικών -
// κανένα αρχείο στο δίσκο. Κυριαρχείται μόνο από LicenseStream.
Doconut.DoconutHost.Initialize(options =>
{
    options.LicenseContent = Environment.GetEnvironmentVariable("DOCONUT_LICENSE") ?? "";
});

Αυτόματη ανίχνευση

Μην ορίσετε καμία από τις τρεις, και το Doconut ψάχνει την άδεια από μόνο του:

csharp
// Μην ρυθμίσετε τίποτα και το Doconut αναζητά την άδεια αυτόματα, με αυτή τη σειρά:
//   1. {CurrentDirectory}\wwwroot
//   2. {AppContext.BaseDirectory}\wwwroot   (under IIS: το ριζικό φάκελο του site's)
// Αναζητά πρώτα το Doconut.lic· αν λείπει, το Doconut.Viewer.lic συν οποιοδήποτε
// αρχεία per-plugin Doconut.Viewer.<Capability>.lic.
Doconut.DoconutHost.Initialize();

Οι δύο φάκελοι, με τη σειρά, και τα αρχεία που αναζητούνται:

text
1. {CurrentDirectory}\wwwroot
2. {AppContext.BaseDirectory}\wwwroot

Filenames, in order (each one looked for in folder 1, then folder 2):
  Doconut.lic                        — legacy all-in-one license; if found, nothing else is read
  Doconut.Viewer.lic                 — base viewer license
  Doconut.Viewer.<Capability>.lic    — per-plugin licenses, read only when Doconut.Viewer.lic was found

Κάτω από το IIS και το IIS Express, το AppContext.BaseDirectory είναι ο ριζικός φάκελος του ιστότοπου — αυτός που περιέχει το Web.config — όχι ο φάκελος του bin. Έτσι η άδεια πρέπει να βρίσκεται στο wwwroot κάτω από τη ρίζα του ιστότοπου:

text
MySite\
  Web.config
  Global.asax
  bin\
  wwwroot\
    Doconut.Viewer.lic
    Doconut.Viewer.Converter.lic

Στο έργο, διατηρήστε το wwwroot\*.lic δίπλα στο Web.config και αναπτύξτε τον φάκελο με τον ιστότοπο. Δεν απαιτείται βήμα κατασκευής για αντιγραφή του οπουδήποτε. Ένα .lic οπουδήποτε αλλού — στο bin\, δίπλα στο Web.config, ή σε υποφάκελο του wwwroot — δεν διαβάζεται ποτέ.

Κρατήστε τα αρχεία .lic εκτός ελέγχου πηγής. Αναπτύξτε τα παράλληλα με τον ιστότοπο, ή παρέχετε την άδεια μέσω του LicenseContent ή του LicenseStream από το μυστικό σας αποθηκευτικό χώρο.

Τι συμβαίνει χωρίς άδεια

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

Ένα αρχείο άδειας που βρέθηκε αλλά απορρίφθηκε είναι διαφορετικό. Μια μη έγκυρη υπογραφή, παραποίηση ή μια έκδοση εκτός του χρονικού παραθύρου της άδειας κάνει το OpenDocumentAsync να ρίξει το LicenseException με τον λόγο. Μια ληγμένη Προσωρινή άδεια συνεχίζει σε λειτουργία με υδατογράφημα. Μια επί πληρωμή άδεια της οποίας η ημερομηνία συνδρομής έχει περάσει παραμένει λειτουργική, καθαρή και με τις δυνατότητές της, σε κάθε έκδοση που κυκλοφόρησε πριν από εκείνη την ημερομηνία.

Τα πρόσθετα χρειάζονται την άδειά τους κατά την εκκίνηση

Η καταχώρηση ενός πρόσθετου του οποίου η δυνατότητα δεν χορηγείται από άδεια σταματά την εφαρμογή κατά την εκκίνηση. DoconutHost.Initialize ρίχνει στο Application_Start:

text
InvalidOperationException: The Converter plugin is registered via AddPlugin but no active
license grants Converter. Remove the AddPlugin<...>() call or install a license (or
trial/demo) that includes Converter.

Στο System.Web, δεν βλέπετε αυτό το μήνυμα στο πρόγραμμα περιήγησης. Κάθε αίτηση προς τον ιστότοπο απαντά με ένα κενό 500 — χωρίς σελίδα σφάλματος, χωρίς στοίβα εντολών, τίποτα στο αρχείο καταγραφής IIS. Η εξαίρεση καταγράφεται μόνο στο Windows event log (Application log, source ASP.NET). Εάν ολόκληρος ο ιστότοπος σταματήσει να ανταποκρίνεται αμέσως μετά την προσθήκη μιας γραμμής AddPlugin, ελέγξτε τα αρχεία άδειας στο wwwroot πριν από τον κώδικα: το Doconut.Viewer.<Capability>.lic του πρόσθετου πρέπει να βρίσκεται δίπλα στο Doconut.Viewer.lic, και χωρίς τη βασική άδεια τα αρχεία του πρόσθετου δεν διαβάζονται καθόλου.

Επαλήθευση της φορτωμένης άδειας

IDoconutLicenseService είναι η ίδια πηγή αλήθειας που χρησιμοποιεί το SDK. Εξάγετε το από DoconutHost.Services για να εκθέσετε ένα πιστοποιημένο διαγνωστικό endpoint ή να ελέγξετε τα feature flags — ποτέ μην επιστρέφετε το περιεχόμενο της άδειας:

csharp
// GET /License/Status
public ActionResult Status()
{
    var license = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();

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

Η άδεια διαβάζεται μία φορά, στο DoconutHost.Initialize. Μετά την αντικατάσταση ενός αρχείου άδειας, επανακυκλώστε την ομάδα εφαρμογών (ή αγγίξτε το Web.config) ώστε το Application_Start να τρέξει ξανά.

Επίλυση προβλημάτων

ΣύμπτωμαΠιθανή αιτίαΈλεγχος
Ο προβολέας λειτουργεί αλλά κάθε σελίδα έχει υδατογράφημαΔεν βρέθηκε άδειαΒρίσκεται το .lic στο <site root>\wwwroot; Καλέστε το status endpoint παραπάνω
Κάθε αίτηση απαντά με ένα κενό 500 αμέσως μετά την προσθήκη ενός πρόσθετουΈνα καταχωρημένο πρόσθετο δεν έχει άδεια που το χορηγείWindows event log, source ASP.NET· το .lic του πρόσθετου δίπλα στο Doconut.Viewer.lic
LicensePath λειτουργεί στο μηχάνημά σας αλλά όχι στον διακομιστήΜια σχετική διαδρομή που επιλύεται σε σχέση με το φάκελο της διεργασίας εργασίαςΔομήστε το με HostingEnvironment.MapPath("~/wwwroot/...")
Ένα αντικατεστημένο αρχείο .lic δεν έχει αποτέλεσμαΗ άδεια διαβάστηκε όταν η εφαρμογή ξεκίνησεΕπανακυκλώστε την ομάδα εφαρμογών
OpenDocumentAsync ρίχνει το LicenseExceptionΗ άδεια βρέθηκε αλλά απορρίφθηκεΔιαβάστε το μήνυμα εξαίρεσης· μην το εμφανίζετε σε μη αξιόπιστους πελάτες

Επόμενα βήματα

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