Ρύθμιση Άδειας
Πού το Doconut ψάχνει για το αρχείο άδειας
Χωρίς άδεια, το Doconut εξακολουθεί να αποδίδει έγγραφα — κάθε σελίδα φέρει μόνο ένα υδατογράφημα αξιολόγησης. Αυτή η σελίδα καλύπτει τους τέσσερις τρόπους παροχής άδειας και την ακριβή προτεραιότητα όταν ορίζονται περισσότερα από ένα.
Η άδεια φορτώνεται μία φορά, κατά τη διάρκεια του AddDoconut(). Αυτό αποτελεί αλλαγή από τη προηγούμενη βιβλιοθήκη .NET Standard, όπου η άδεια παραχωρούνταν σε μια Viewer παρουσία ή ορίζεται μέσω των στατικών κλήσεων Viewer.DoconutLicense(...) / Viewer.SetLicensePlugin(...). Αυτές οι μέθοδοι δεν αποτελούν μηχανισμό εκκίνησης σε αυτήν την έκδοση — δείτε τον οδηγό μετάβασης.
Τέσσερις τρόποι παροχής άδειας
Υπάρχουν τέσσερις: τρεις ρητές πηγές στο DoconutOptions — μια ροή, ακατέργαστο περιεχόμενο ή διαδρομή αρχείου — συν αυτόματη ανίχνευση όταν καμία από αυτές δεν έχει οριστεί. Όταν ορίζονται περισσότερες από μία, η προτεραιότητα είναι ακριβής:
LicenseStream υπερισχύει του LicenseContent υπερισχύει του LicensePath υπερισχύει της αυτόματης αναζήτησης.
Με διαδρομή
LicensePath περνιέται στο File.Exists ακριβώς όπως δίνεται. Μια σχετική διαδρομή επιλύεται σε σχέση με τον τρέχοντα κατάλογο εργασίας της διεργασίας — όχι τον φάκελο του έργου σας, και όχι τον φάκελο όπου βρίσκεται το Program.cs. Εάν η διαδρομή δεν επιλυθεί, το Doconut δεν πετάει εξαίρεση και δεν επιστρέφει στην αυτόματη αναζήτηση — απλώς δεν φορτώνει άδεια και το πρόγραμμα προβολής προσθέτει υδατογράφημα. Η αυτόματη αναζήτηση εκτελείται μόνο όταν κανένα από τα LicensePath, LicenseContent ή LicenseStream δεν είναι ορισμένο. Τα αρχεία άδειας ανά plugin στον ίδιο φάκελο (Doconut.Viewer.<Capability>.lic) διαβάζονται μαζί του, έτσι τα LicensePath και AddPlugin<...>() λειτουργούν μαζί όταν οι άδειες των plugin βρίσκονται δίπλα στην κύρια άδεια.
Προτιμήστε μια απόλυτη διαδρομή (για παράδειγμα δημιουργημένη από IWebHostEnvironment.WebRootPath ή AppContext.BaseDirectory), ή παραλείψτε εντελώς το LicensePath και βασιστείτε στην αυτόματη ανίχνευση παρακάτω.
builder.Services.AddDoconut(options =>
{
options.LicensePath = Path.Combine(AppContext.BaseDirectory, "wwwroot", "Doconut.Viewer.lic");
});Με ροή
LicenseStream διαβάζεται μία φορά κατά την εκκίνηση — χρήσιμο όταν η άδεια προέρχεται από ένα μυστικό αποθετήριο αντί για αρχείο στο δίσκο.
// Προτεραιότητα: LicenseStream > LicenseContent > LicensePath > αυτόματη αναζήτηση.
builder.Services.AddDoconut(options =>
{
options.LicenseStream = licenseStream;
});Με περιεχόμενο
LicenseContent δέχεται το ίδιο το κείμενο της άδειας — από μεταβλητή περιβάλλοντος, βάση δεδομένων ή διαχειριστή μυστικών:
// License XML από βάση δεδομένων, μεταβλητή περιβάλλοντος ή διαχειριστή μυστικών —
// χωρίς αρχείο στο δίσκο. Υπερτερείται μόνο από LicenseStream.
builder.Services.AddDoconut(options =>
{
options.LicenseContent = Environment.GetEnvironmentVariable("DOCONUT_LICENSE") ?? "";
});Αυτόματη ανίχνευση
Μη ρυθμίσετε καμία από τις τρεις ρητές πηγές, και το Doconut θα ψάξει την άδεια αυτόματα:
// Μην ρυθμίσετε τίποτα και το Doconut ψάχνει για την άδεια μόνο του, μόνο σε αυτούς τους δύο φακέλους:
// 1. {CurrentDirectory}/wwwroot
// 2. {AppContext.BaseDirectory}/wwwroot (wwwroot μέσα στο φάκελο εξόδου κατασκευής)
// Αναζητά πρώτα το Doconut.lic· αν λείπει, το Doconut.Viewer.lic συν οποιοδήποτε
// ανά δυνατότητα Doconut.Viewer.<Capability>.lic αρχεία.
builder.Services.AddDoconut();Οι φάκελοι ανίχνευσης, με τη σειρά, και τα ονόματα αρχείων που αναζητούνται:
Ονόματα αρχείων, με τη σειρά (κάθε ένα αναζητείται στον φάκελο 1, μετά στον φάκελο 2):
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-capability licenses, read only when Doconut.Viewer.lic was foundΤίποτα εκτός ενός φακέλου wwwroot δεν διαβάζεται: ένα .lic στον ίδιο φάκελο εξόδου, ή στο wwwroot/lib, αγνοείται.
Αν προηγουμένως περάσατε ένα List<string> διαδρομών άδειας στον κατασκευαστή Viewer — ένα ανά δυνατότητα — κρατήστε αυτά τα συνοδευτικά αρχεία δίπλα στο Doconut.Viewer.lic και αφήστε την αυτόματη ανίχνευση να τα εντοπίσει. Δεν υπάρχει επιλογή λίστας διαδρομών στο DoconutOptions.
Αντιγράψτε την άδεια στο φάκελο εξόδου
Όταν η διαδικασία δεν εκτελείται από το φάκελο του έργου — μια δημοσιευμένη εφαρμογή, IIS, ένα κοντέινερ, ένας εκτελεστής δοκιμών — η πρώτη προσπάθεια αποτυγχάνει, και η δεύτερη, {AppContext.BaseDirectory}/wwwroot, πρέπει να βρει το αρχείο. Αυτό το στόχο MSBuild αντιγράφει τις άδειες εκεί σε κάθε κατασκευή:
<Target Name="CopyLicensesToOutput" AfterTargets="Build">
<ItemGroup>
<DoconutLicenseFiles Include="$(MSBuildProjectDirectory)\wwwroot\*.lic" />
<StaleOutputLicenses Include="$(OutDir)wwwroot\*.lic" />
</ItemGroup>
<!-- Διαγράψτε πρώτα, ώστε η μετονομασία ή η αφαίρεση ενός .lic στο wwwroot να το αφαιρεί επίσης από την έξοδο. -->
<Delete Files="@(StaleOutputLicenses)" />
<Copy SourceFiles="@(DoconutLicenseFiles)" DestinationFolder="$(OutDir)wwwroot" />
</Target>Ο προορισμός πρέπει να είναι $(OutDir)wwwroot: ένα .lic που αντιγράφεται στη ρίζα εξόδου δεν εντοπίζεται ποτέ από την αυτόματη αναζήτηση. Τα παραδείγματα LicensePath σε αυτή τη σελίδα δείχνουν στην ίδια θέση.
Κρατήστε τα αρχεία
.licεκτός ελέγχου έκδοσης — αναπτύξτε τα δίπλα στην εφαρμογή, ή ενσωματώστε την άδεια μέσωLicenseContentήLicenseStreamαπό το μυστικό σας αποθετήριο.
Τι συμβαίνει χωρίς άδεια
Η απουσία άδειας δεν προκαλεί εξαίρεση. AddDoconut() ολοκληρώνεται επιτυχώς, η εφαρμογή ξεκινά, και ο προβολέας εκτελείται — αλλά κάθε σελίδα φέρει ένα υδατογράφημα αξιολόγησης και δεν χορηγείται καμία προαιρετική δυνατότητα.
Ένα αρχείο άδειας που εντοπίζεται αλλά απορρίπτεται είναι διαφορετικό. Μια μη έγκυρη υπογραφή, παραποίηση, μαύρη λίστα ή μια κατασκευή εκτός του χρονικού παραθύρου έκδοσης της άδειας προκαλεί το OpenDocumentAsync να ρίξει LicenseException με License.RejectionMessage. Μια ληγμένη Προσωρινή άδεια συνεχίζει σε κατάσταση υδατογραφήματος. Μια πληρωμένη άδεια της οποίας η ημερομηνία συνδρομής έχει περάσει παραμένει λειτουργική, καθαρή και με τις δυνατότητές της, σε κάθε κατασκευή που κυκλοφόρησε πριν από αυτήν την ημερομηνία.
Τα πρόσθετα χρειάζονται δυνατότητες
Η καταχώριση ενός πρόσθετου χωρίς αντίστοιχη άδεια είναι διαφορετική: για μια ελλιπή άδεια, ένα παλιό αρχείο TRIAL, ή μια πληρωμένη άδεια χωρίς αυτή τη δυνατότητα, το AddDoconut() ρίχνει InvalidOperationException, έτσι η εφαρμογή δεν ξεκινά. Για παράδειγμα, η καταχώριση του πρόσθετου Converter χωρίς άδεια που χορηγεί Converter:
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.Το μήνυμα σας λέει άμεσα τη διόρθωση: είτε αφαιρέστε την κλήση options.AddPlugin<...>() για εκείνο το πρόσθετο, είτε εγκαταστήστε μια πληρωμένη άδεια ή μια ενεργή Προσωρινή/Δοκιμαστική (NFR) άδεια που χορηγεί τη δυνατότητα. Οι προσωρινές καταχωρίσεις επιτρέπεται να επιβιώνουν μετά τη λήξη τους ώστε μια ήδη ρυθμισμένη εφαρμογή να υποβαθμίζεται κατά την εκτέλεση αντί να καταρρέει κατά την επανεκκίνηση· μόλις λήξουν, οι δυνατότητές τους παραμένουν ανακλημένες.
Επαληθεύστε την φορτωμένη άδεια
Χρησιμοποιήστε το IDoconutLicenseService, την ίδια πηγή αλήθειας που χρησιμοποιεί το SDK, για να εκθέσετε ένα πιστοποιημένο διαγνωστικό endpoint ή για να ελέγξετε τις σημαίες χαρακτηριστικών. Μην επιστρέφετε το περιεχόμενο ή τα κλειδιά της άδειας.
app.MapGet("/api/doconut/license", (IDoconutLicenseService license) => Results.Ok(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
}));Η άδεια διαβάζεται κατά την καταχώριση AddDoconut(). Το ResetLicense είναι επί του παρόντος μια ιδιότητα συμβατότητας χωρίς ενεργή διαδρομή επαναφόρτωσης, έτσι η αντικατάσταση ενός αρχείου άδειας απαιτεί επανεκκίνηση της εφαρμογής.
Πίνακας αντιμετώπισης προβλημάτων
| Συμπτωμα | Πιθανή αιτία | Έλεγχος |
|---|---|---|
| Ο προβολέας λειτουργεί αλλά κάθε σελίδα είναι υδατογραφημένη | Δεν φορτώθηκε άδεια, ή η Προσωρινή άδεια έχει λήξει | Επίλυση IDoconutLicenseService· επαλήθευση του καταλόγου εξόδου και του καταλόγου εργασίας της διεργασίας |
AddDoconut() ρίχνει για ένα πρόσθετο | Η άδεια δεν χορηγεί αυτή τη δυνατότητα πρόσθετου | Ελέγξτε IsCapabilityGranted(...) και αφαιρέστε τις καταχωρίσεις που δεν αγοράσατε |
| Μια ρυθμισμένη σχετική διαδρομή λειτουργεί τοπικά αλλά όχι σε IIS/κοντέινερ | Ο κατάλογος εργασίας της διεργασίας άλλαξε | Χρησιμοποιήστε AppContext.BaseDirectory ή μια απόλυτη διαδρομή |
Το αντικατεστημένο αρχείο .lic δεν έχει αποτέλεσμα | Η υπηρεσία άδειας singleton είχε ήδη δημιουργηθεί | Επανεκκινήστε την εφαρμογή |
OpenDocumentAsync ρίχνει LicenseException | Η υπογραφή, ο τομέας, το χρονικό παράθυρο έκδοσης, η μαύρη λίστα ή η πύλη χρόνου εκτέλεσης του πρόσθετου απέρριψαν την άδεια | Διαβάστε το μήνυμα εξαίρεσης/απόρριψης χωρίς να το εκθέσετε σε μη αξιόπιστους πελάτες |
| Μια άδεια ανά δυνατότητα λειτουργούσε πριν αλλά όχι τώρα | Ο παλιός κώδικας διέδιδε ρητές διαδρομές άδειας στον κατασκευαστή Viewer | Μετακινήστε τα συνοδευτικά αρχεία .lic δίπλα στο Doconut.Viewer.lic και αφήστε την αυτόματη ανίχνευση να τα φορτώσει |
Επόμενα βήματα
- Αδειοδότηση — δυνατότητες, επίπεδα αδειών και επαλήθευση του τι φορτώθηκε κατά την εκτέλεση.
- Αντιμετώπιση προβλημάτων — υδατογραφήματα, απορριπτέες άδειες και σφάλματα δυνατότητας.
Ήταν αυτή η σελίδα χρήσιμη;