Ρύθμιση Άδειας
Πού το Doconut ψάχνει το αρχείο άδειας
Χωρίς άδεια, το Doconut εξακολουθεί να αποδίδει έγγραφα — κάθε σελίδα φέρει μόνο ένα υδατογράφημα αξιολόγησης. Αυτή η σελίδα καλύπτει τους τέσσερις τρόπους παροχής άδειας και την ακριβή προτεραιότητα όταν ορίζονται περισσότερα από ένα.
Τέσσερις τρόποι παροχής άδειας
Υπάρχουν τέσσερις: τρεις σαφείς πηγές στο DoconutOptions — μια ροή, ακατέργαστο περιεχόμενο ή μια διαδρομή αρχείου — συν την αυτόματη ανίχνευση όταν καμία δεν έχει οριστεί. Όταν ορίζονται περισσότερα από ένα, η προτεραιότητα είναι ακριβής:
LicenseStream υπερισχύει του LicenseContent, υπερισχύει του LicensePath, υπερισχύει του auto-search.
Με διαδρομή
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 δέχεται το κείμενο της άδειας απευθείας — από μεταβλητή περιβάλλοντος, βάση δεδομένων ή διαχειριστή μυστικών:
// Αρχείο 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 συν οποιοδήποτε
// αρχεία per-plugin Doconut.Viewer.<Capability>.lic.
builder.Services.AddDoconut();Οι φάκελοι ανίχνευσης, με τη σειρά, και τα ονόματα αρχείων που αναζητούνται:
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Τίποτα εκτός ενός φακέλου wwwroot δεν διαβάζεται: ένα .lic στον ίδιο φάκελο εξόδου, ή στο wwwroot/lib, αγνοείται.
Αντιγράψτε την άδεια στον φάκελο εξόδου σας
Όταν η διεργασία δεν εκτελείται από τον φάκελο του έργου — μια δημοσιευμένη εφαρμογή, 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, για να εκθέσετε ένα πιστοποιημένο διαγνωστικό σημείο λήψης ή για να ελέγξετε τις σημαίες χαρακτηριστικών. Μην επιστρέφετε το περιεχόμενο ή τα κλειδιά της άδειας.
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/container | Ο τρέχων φάκελος εργασίας της διεργασίας άλλαξε | Χρησιμοποιήστε το AppContext.BaseDirectory ή μια απόλυτη διαδρομή |
Αντικατεστημένο αρχείο .lic δεν έχει αποτέλεσμα | Η υπηρεσία άδειας singleton είχε ήδη δημιουργηθεί | Επανεκκινήστε την εφαρμογή |
OpenDocumentAsync πετάει LicenseException | Η υπογραφή, ο τομέας, το παράθυρο έκδοσης, η μαύρη λίστα ή η πύλη χρόνου εκτέλεσης του πρόσθετου απέρριψαν την άδεια | Διαβάστε το μήνυμα εξαίρεσης/απόρριψης χωρίς να το εκθέσετε σε μη αξιόπιστους πελάτες |
Επόμενα βήματα
- Αδειοδότηση — δυνατότητες, επίπεδα αδειών και επαλήθευση του τι φορτώθηκε κατά την εκτέλεση.
- Αντιμετώπιση προβλημάτων — υδατογραφήματα, απορριφθείσες άδειες και σφάλματα δυνατότητας.
Ήταν αυτή η σελίδα χρήσιμη;