Lizenzeinrichtung
Wo Doconut nach Ihrer Lizenzdatei sucht
Ohne Lizenz rendert Doconut weiterhin Dokumente — jede Seite trägt lediglich ein Evaluations‑Wasserzeichen. Diese Seite beschreibt die vier Möglichkeiten, eine Lizenz bereitzustellen, und die genaue Priorität, wenn mehr als eine gesetzt ist.
Vier Möglichkeiten, eine Lizenz bereitzustellen
Es gibt vier: drei explizite Quellen auf DoconutOptions — ein Stream, roher Inhalt oder ein Dateipfad — plus automatische Erkennung, wenn keine davon gesetzt ist. Wenn mehr als eine gesetzt ist, ist die Priorität exakt:
LicenseStream schlägt LicenseContent schlägt LicensePath schlägt Auto‑Suche.
Nach Pfad
LicensePath wird an File.Exists exakt so übergeben, wie angegeben. Ein relativer Pfad wird relativ zum aktuellen Arbeitsverzeichnis des Prozesses aufgelöst — nicht Ihr Projektordner und nicht der Ordner, in dem Program.cs lebt. Wenn der Pfad nicht aufgelöst werden kann, wirft Doconut keinen Fehler und fällt nicht auf die Auto‑Suche zurück — es lädt einfach keine Lizenz und der Viewer fügt ein Wasserzeichen ein. Auto‑Suche wird nur ausgeführt, wenn weder LicensePath, LicenseContent noch LicenseStream gesetzt ist. Die pro‑Plugin‑Lizenzdateien im selben Ordner (Doconut.Viewer.<Capability>.lic) werden dabei gelesen, sodass LicensePath und AddPlugin<...>() zusammenarbeiten, wenn die Plugin‑Lizenzen neben der Basislizenz liegen.
Bevorzugen Sie einen absoluten Pfad (zum Beispiel erstellt aus IWebHostEnvironment.WebRootPath oder AppContext.BaseDirectory) oder lassen Sie LicensePath vollständig weg und verlassen Sie sich auf die automatische Erkennung weiter unten.
builder.Services.AddDoconut(options =>
{
options.LicensePath = Path.Combine(AppContext.BaseDirectory, "wwwroot", "Doconut.Viewer.lic");
});Per Stream
LicenseStream wird einmal beim Start gelesen — nützlich, wenn die Lizenz aus einem geheimen Speicher stammt statt aus einer Datei auf der Festplatte.
// Priorität: LicenseStream > LicenseContent > LicensePath > Auto-Suche.
builder.Services.AddDoconut(options =>
{
options.LicenseStream = licenseStream;
});Nach Inhalt
LicenseContent akzeptiert den Lizenztext selbst — aus einer Umgebungsvariable, einer Datenbank oder einem Geheimnis‑Manager:
// Lizenz-XML aus einer Datenbank, Umgebungsvariable oder Geheimnis-Manager —
// Keine Datei auf der Festplatte. Nur von LicenseStream übertroffen.
builder.Services.AddDoconut(options =>
{
options.LicenseContent = Environment.GetEnvironmentVariable("DOCONUT_LICENSE") ?? "";
});Automatische Erkennung
Konfigurieren Sie keine der drei expliziten Quellen, und Doconut sucht die Lizenz selbst:
// Nichts konfigurieren, und Doconut sucht die Lizenz selbst, nur in diesen beiden Ordnern:
// 1. {CurrentDirectory}/wwwroot
// 2. {AppContext.BaseDirectory}/wwwroot (wwwroot im Build-Ausgabeverzeichnis)
// Es sucht zuerst nach Doconut.lic; falls diese fehlt, nach Doconut.Viewer.lic plus allen
// pro Plugin Doconut.Viewer.<Capability>.lic Dateien.
builder.Services.AddDoconut();Die zu prüfenden Ordner in der Reihenfolge und die gesuchten Dateinamen:
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 foundNichts außerhalb eines wwwroot‑Ordners wird gelesen: ein .lic im Ausgabeverzeichnis selbst oder in wwwroot/lib wird ignoriert.
Kopieren Sie die Lizenz in Ihren Ausgabordner
Wenn der Prozess nicht aus dem Projektordner ausgeführt wird — eine veröffentlichte Anwendung, IIS, ein Container, ein Test‑Runner — verfehlt die erste Prüfung, und die zweite, {AppContext.BaseDirectory}/wwwroot, muss die Datei finden. Dieses MSBuild‑Target kopiert die Lizenzen bei jedem Build dorthin:
<Target Name="CopyLicensesToOutput" AfterTargets="Build">
<ItemGroup>
<DoconutLicenseFiles Include="$(MSBuildProjectDirectory)\wwwroot\*.lic" />
<StaleOutputLicenses Include="$(OutDir)wwwroot\*.lic" />
</ItemGroup>
<!-- Zuerst löschen, damit das Umbenennen oder Entfernen einer .lic in wwwroot sie auch aus der Ausgabe entfernt. -->
<Delete Files="@(StaleOutputLicenses)" />
<Copy SourceFiles="@(DoconutLicenseFiles)" DestinationFolder="$(OutDir)wwwroot" />
</Target>Das Ziel muss $(OutDir)wwwroot sein: ein .lic, das in das Ausgabeverzeichnis kopiert wird, wird von der Auto‑Suche nie gefunden. Die LicensePath‑Beispiele auf dieser Seite verweisen auf denselben Ort.
Halten Sie
.lic‑Dateien außerhalb der Versionskontrolle — stellen Sie sie zusammen mit der Anwendung bereit oder injizieren Sie die Lizenz überLicenseContentbzw.LicenseStreamaus Ihrem Geheimnis‑Speicher.
Was passiert ohne Lizenz
Eine fehlende Lizenz wirft keinen Fehler. AddDoconut() gelingt, die Anwendung startet und der Viewer läuft — aber jede Seite trägt ein Evaluationswasserzeichen und es wird keine optionale Fähigkeit gewährt.
Eine gefundene, aber abgelehnte Lizenzdatei ist etwas anderes. Eine ungültige Signatur, Manipulation, Blacklisting oder ein Build außerhalb des Versionsfensters der Lizenz führt dazu, dass OpenDocumentAsync einen LicenseException mit License.RejectionMessage wirft. Eine abgelaufene temporäre Lizenz läuft im wasserzeichen‑Modus weiter. Eine kostenpflichtige Lizenz, deren Abonnementdatum abgelaufen ist, funktioniert weiterhin sauber und mit ihren Fähigkeiten bei jedem Build, der vor diesem Datum veröffentlicht wurde.
Plugins benötigen Fähigkeiten
Das Registrieren eines Plugins ohne entsprechende Berechtigung ist anders: Bei einer fehlenden Lizenz, einer veralteten TRIAL‑Datei oder einer kostenpflichtigen Lizenz ohne diese Fähigkeit wirft AddDoconut() einen InvalidOperationException, sodass die Anwendung nicht startet. Zum Beispiel das Registrieren des Converter‑Plugins ohne eine Lizenz, die Converter gewährt:
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.Die Meldung gibt die Lösung direkt an: Entfernen Sie entweder den options.AddPlugin<...>()‑Aufruf für dieses Plugin oder installieren Sie eine kostenpflichtige Lizenz bzw. eine aktive temporäre/Demo‑ (NFR‑) Lizenz, die die Fähigkeit gewährt. Temporäre Registrierungen dürfen ihr Ablaufdatum überleben, sodass eine bereits konfigurierte Anwendung zur Laufzeit degradieren kann, anstatt beim Neustart abzustürzen; nach Ablauf bleiben ihre Fähigkeiten dennoch entzogen.
Überprüfen der geladenen Lizenz
Verwenden Sie IDoconutLicenseService, die gleiche zuverlässige Quelle, die vom SDK verwendet wird, um einen authentifizierten Diagnose‑Endpunkt bereitzustellen oder Feature‑Flags zu steuern. Geben Sie keine Lizenzinhalte oder Schlüssel zurück.
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
}));Die Lizenz wird während der AddDoconut()‑Registrierung gelesen. ResetLicense ist derzeit eine Kompatibilitätseigenschaft ohne aktiven Neulade‑Pfad, sodass das Ersetzen einer Lizenzdatei einen Neustart der Anwendung erfordert.
Fehlersuchmatrix
| Symptom | Wahrscheinliche Ursache | Prüfen |
|---|---|---|
| Viewer funktioniert, aber jede Seite ist mit Wasserzeichen versehen | Keine Lizenz wurde geladen, oder die temporäre Lizenz ist abgelaufen | Lösen Sie IDoconutLicenseService; überprüfen Sie das Ausgabeverzeichnis und das Arbeitsverzeichnis des Prozesses |
AddDoconut() wirft für ein Plugin | Die Lizenz gewährt diese Plugin‑Fähigkeit nicht | Prüfen Sie IsCapabilityGranted(...) und entfernen Sie Registrierungen, die Sie nicht gekauft haben |
| Ein konfigurierter relativer Pfad funktioniert lokal, aber nicht in IIS/Container | Das Arbeitsverzeichnis des Prozesses hat sich geändert | Verwenden Sie AppContext.BaseDirectory oder einen absoluten Pfad |
Ersetzte .lic‑Datei hat keine Wirkung | Der Singleton‑Lizenzservice war bereits erstellt | Starten Sie die Anwendung neu |
OpenDocumentAsync wirft LicenseException | Signatur, Domain, Versionsfenster, Blacklist oder Plugin‑Runtime‑Gate haben die Lizenz abgelehnt | Lesen Sie die Ausnahme‑/Ablehnungsnachricht, ohne sie unzuverlässigen Clients preiszugeben |
Nächste Schritte
- Lizenzierung — Fähigkeiten, Lizenzstufen und Überprüfung, was zur Laufzeit geladen wurde.
- Fehlerbehebung — Wasserzeichen, abgelehnte Lizenzen und Fähigkeitsfehler.
War diese Seite hilfreich?