Ρύθμιση Άδειας
Πού ψάχνει το Doconut για το αρχείο άδειας σας κάτω από το IIS
Χωρίς άδεια, το Doconut εξακολουθεί να αποδίδει έγγραφα — κάθε σελίδα φέρει μόνο ένα υδατογράφημα αξιολόγησης. Αυτή η σελίδα καλύπτει τους τέσσερις τρόπους παροχής άδειας στο Global.asax, πού ψάχνει το Doconut όταν δεν παρέχετε καμία, και τι συμβαίνει όταν λείπει η άδεια ενός πρόσθετου.
Τέσσερις τρόποι παροχής άδειας
Υπάρχουν τρεις σαφείς πηγές στο DoconutOptions — διαδρομή αρχείου, ροή ή ακατέργαστο περιεχόμενο — συν αυτόματη ανίχνευση όταν καμία δεν έχει οριστεί. Όλες διαβάζονται μία φορά, στο DoconutHost.Initialize. Όταν ορίζονται περισσότερες από μία, η προτεραιότητα είναι ακριβής:
LicenseStream υπερισχύει του LicenseContent, υπερισχύει του LicensePath, υπερισχύει της αυτόματης ανίχνευσης.
Με διαδρομή
Δώστε στο LicensePath μια πλήρη διαδρομή. Μια σχετική διαδρομή επιλύεται σε σχέση με τον τρέχοντα φάκελο της διεργασίας, και κάτω από το IIS αυτός είναι ο φάκελος της διεργασίας εργαζόμενου, όχι του ιστότοπού σας. Το HostingEnvironment.MapPath μετατρέπει μια διαδρομή σχετική με τον ιστότοπο σε πλήρη:
Doconut.DoconutHost.Initialize(options =>
{
options.LicensePath = HostingEnvironment.MapPath("~/wwwroot/Doconut.Viewer.lic");
});Αν το αρχείο δεν υπάρχει, το Doconut δεν πετάει εξαίρεση και δεν επιστρέφει στην αυτόματη ανίχνευση: δεν φορτώνει άδεια, και ο προβολέας προσθέτει υδατογραφήματα. Τα αρχεία άδειας ανά πρόσθετο στον ίδιο φάκελο (Doconut.Viewer.<Capability>.lic) διαβάζονται μαζί του, έτσι τα LicensePath και AddPlugin<...>() λειτουργούν μαζί όταν οι άδειες των πρόσθετων βρίσκονται δίπλα στην κύρια άδεια.
Με ροή
Το LicenseStream διαβάζεται μία φορά, κατά την εκκίνηση — χρήσιμο όταν η άδεια προέρχεται από ενσωματωμένο πόρο ή μυστικό αποθηκευτικό χώρο αντί για αρχείο στο δίσκο.
// Προτεραιότητα: LicenseStream > LicenseContent > LicensePath > αυτόματη αναζήτηση.
Doconut.DoconutHost.Initialize(options =>
{
options.LicenseStream = licenseStream;
});Με περιεχόμενο
Το LicenseContent λαμβάνει το ίδιο το κείμενο της άδειας — από μεταβλητή περιβάλλοντος, βάση δεδομένων ή μυστικό αποθηκευτικό χώρο — ώστε να μην χρειάζεται να αναπτυχθεί αρχείο άδειας με τον ιστότοπο.
// License XML από μια βάση δεδομένων, μια μεταβλητή περιβάλλοντος ή ένα κατάστημα μυστικών -
// κανένα αρχείο στο δίσκο. Κυριαρχείται μόνο από LicenseStream.
Doconut.DoconutHost.Initialize(options =>
{
options.LicenseContent = Environment.GetEnvironmentVariable("DOCONUT_LICENSE") ?? "";
});Αυτόματη ανίχνευση
Μην ορίσετε καμία από τις τρεις, και το Doconut ψάχνει την άδεια από μόνο του:
// Μην ρυθμίσετε τίποτα και το 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();Οι δύο φάκελοι, με τη σειρά, και τα αρχεία που αναζητούνται:
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 κάτω από τη ρίζα του ιστότοπου:
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:
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 — ποτέ μην επιστρέφετε το περιεχόμενο της άδειας:
// 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 | Η άδεια βρέθηκε αλλά απορρίφθηκε | Διαβάστε το μήνυμα εξαίρεσης· μην το εμφανίζετε σε μη αξιόπιστους πελάτες |
Επόμενα βήματα
- Αδειοδότηση — δυνατότητες, και πώς να τις ελέγξετε σε χρόνο εκτέλεσης.
- Επίλυση προβλημάτων — υδατογραφήματα, αποτυχίες εκκίνησης, και άλλα συμπτώματα.
Ήταν αυτή η σελίδα χρήσιμη;