Lizenzierung
Funktionen, Lizenzstufen und der Lizenzservice
Diese Seite ist die Laufzeitreferenz dafür, wie eine Lizenz das Verhalten von Doconut bestimmt: was jeder Lizenzstatus erlaubt, wie Fähigkeiten gewährt werden und wie man das alles aus dem Code heraus inspiziert. (Zum Laden einer Lizenz siehe Erste Schritte → Lizenz‑Einrichtung.)
Lizenzstatus und ihre Funktionen
| Status | Öffnet Dokumente? | Wasserzeichen | Fähigkeiten |
|---|---|---|---|
| Vollständige (bezahlte) Lizenz (dieser Build wurde vor seinem Abonnementdatum veröffentlicht) | Ja | Keines | Die erworbenen (Has* Flags) |
| Temporäre Lizenz (Entwickler/NFR — die Evaluierungslizenz, vor ihrem Ablaufdatum) | Ja | Keines im Basisviewer; Plugin-Ausgabe ist mit Wasserzeichen versehen | Alle — Pauschalgewährung (der Evaluierungs‑Funnel) |
Abgelaufene temporäre Lizenz (nach ihrem LicenseExpiry Datum) | Ja | Evaluierungswasserzeichen | Keine gewährt |
| Keine Lizenzdatei vorhanden | Ja | Evaluierungswasserzeichen | Keine gewährt |
| Gefunden, aber abgelehnt (ungültige Signatur, manipuliert, gesperrt oder ein Build, der nach dem Abonnementdatum der Lizenz veröffentlicht wurde) | Nein — LicenseException bei jedem Öffnen | — | — |
Eine bezahlte Lizenz, deren Abonnementdatum überschritten ist, funktioniert weiterhin — sauber, mit ihren Fähigkeiten — auf jedem Build, der vor diesem Datum veröffentlicht wurde. Nur ein nach diesem Datum veröffentlichter Build wird abgelehnt.
Zwei Konsequenzen, die es zu verinnerlichen gilt:
- Eine fehlende Lizenz ist keine temporäre Lizenz. Ohne Lizenzdatei werden Seiten mit Wasserzeichen dargestellt und keine Fähigkeit (Suche, Annotation, Plugins) ist aktiv. Das voll funktionsfähige, wasserzeichenfreie Erlebnis erfordert eine tatsächliche Temporäre Lizenz (eine erhalten).
- Nur eine abgelehnte Lizenz blockiert das Öffnen. Eine abgelaufene temporäre Lizenz lässt die App mit dem Evaluierungswasserzeichen weiterlaufen, und eine bezahlte Lizenz, deren Abonnementdatum überschritten ist, bleibt auf den von ihr abgedeckten Builds sauber; jedoch wird ein nach dem Abonnementdatum der Lizenz veröffentlichter Build abgelehnt und bricht sofort ab mit einem
LicenseException, sodass Sie ihn beim Deployment erkennen — nicht durch stillschweigendes Ausliefern von wasserzeichenbehafteten Ausgaben. Diese Ausnahme (vonOpenDocumentAsync) enthält den Grund ausLicense.RejectionMessage.
Fähigkeiten
Doconut steuert optionale Funktionalität über Fähigkeit. Es umfasst die integrierten Funktionen Suche und Annotation sowie die optionalen Plugins Converter, Dicom und Signer, die jeweils durch Ihre Lizenz gewährt werden. Der Basisviewer ist keine Fähigkeit — er ist die Voraussetzung, dargestellt als IsViewerLicensed:
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // non-TRIAL Lizenz vorhanden UND deckt die Version dieses Builds abDas einzige Gate, das die gesamte Pipeline verwendet, ist IsCapabilityGranted:
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool searchGranted = lic.IsCapabilityGranted(LicenseCapability.Search);Seine Logik, wortwörtlich aus der Implementierung: Eine aktive (nicht abgelaufene) Temporäre Lizenz gewährt jede Fähigkeit — einschließlich Fähigkeiten, für die noch kein dediziertes Kauf‑Flag existiert; eine echte gekaufte Lizenz gewährt exakt ihre Has* Flags und ist standardmäßig verweigernd für alles, das nicht zugeordnet ist. (Eine Legacy‑TRIAL‑Datei ist keine Berechtigung — sie wird als unlizenzierte Datei behandelt: wasserzeichenbehaftet, nichts gewährt.)
Temporäre Lizenzen
Temporäre (Entwickler/NFR) Lizenzen werden durch ein ExpiryNote Tag gekennzeichnet und besitzen ein festes Ablaufdatum:
| Mitglied | Bedeutung |
|---|---|
IsTemporary | Ein ExpiryNote Tag ist vorhanden (die Erkennung erfolgt über das Vorhandensein des Tags — der Text der Notiz wird nie abgeglichen, er ist dynamisch) |
ExpiryNote | Informations‑Text, der in die Lizenz eingebettet ist |
LicenseExpiry | Das feste Ablaufdatum (DateTime?) |
Die Ablaufsemantik unterscheidet sich je nach Stufe: Eine temporäre Lizenz läuft an ihrem LicenseExpiry nur am Datum ab (ihr Abonnementfenster wird ignoriert; eine temporäre Lizenz ohne Datum wird als abgelaufen behandelt, ausfallsicher). Jede andere Lizenz läuft an ihrem Abonnement‑/Update‑Fenster‑Datum ab; bei einer bezahlten Lizenz gibt IsExpired nur an, dass dieses Datum überschritten wurde — Builds, die davor veröffentlicht wurden, bleiben sauber und behalten ihre Fähigkeiten.
IDoconutLicenseService‑Referenz
Injiziere IDoconutLicenseService (Namespace Doconut.Core.Interfaces; als Singleton registriert — die Lizenz wird beim Start einmal geparst):
| Mitglied | Bedeutung |
|---|---|
License | Vollständiger DoconutLicenseInfo Schnappschuss (unten) |
IsTrial | Eine Legacy‑TRIAL‑Datei (als unlizenzierte Datei behandelt — keine Berechtigung) |
IsTemporary / ExpiryNote / LicenseExpiry | Temporäre Lizenz‑Markierungen |
IsExpired | Abgelaufen gemäß den oben genannten Stufenregeln |
IsVersionValid | Dieser Build liegt innerhalb des Support‑Fensters der Lizenz |
IsViewerLicensed | Nicht‑TRIAL Datei gefunden und Version abgedeckt — Grundvoraussetzung |
IsCapabilityGranted(cap) | Das einzige Fähigkeits‑Gate |
HasSearch HasAnnotation HasEditor HasConverter HasDicom HasDocumentTools HasSigner HasRedactor HasComparer HasForms HasProtector HasCompressor | Ein Flag pro Fähigkeit: von einer Lizenz, die diesen Build abdeckt, erworben oder von einer aktiven temporären Lizenz gewährt. IsCapabilityGranted beantwortet dieselbe Frage nach Fähigkeit |
IsValidForDomain(host) | Host‑Abdeckung; V4‑Lizenzen verwenden das Platzhalter‑Symbol *.* |
LicenseRejectionReason | Nicht leer ⇒ Öffnen wird mit dieser Meldung blockiert |
DoconutLicenseInfo stellt den benutzerfreundlichen Schnappschuss für Admin‑Panels bereit: Owner, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, die Has* Flags, die Felder der temporären Lizenz und RejectionMessage.
// Feature-flag deine UI aus derselben Quelle der Wahrheit, die das SDK verwendet
app.MapGet("/api/features", (IDoconutLicenseService lic) => Results.Ok(new
{
viewer = lic.IsViewerLicensed || lic.IsTemporary,
search = lic.IsCapabilityGranted(LicenseCapability.Search),
annotation = lic.IsCapabilityGranted(LicenseCapability.Annotation),
conversion = lic.HasConverter,
dicom = lic.HasDicom,
}));Gesundheitsprüfung
AddDoconut() registriert einen "doconut" Gesundheits‑Check, der den Lizenz‑/Ablaufstatus über den Standard‑ASP.NET‑Core‑Mechanismus meldet:
app.MapHealthChecks("/health");Binden Sie ihn in Ihre Überwachung ein und ein auslaufendes Abonnement wird zu einer Warnung statt zu einem Support‑Ticket. Der Check meldet Unhealthy, wenn die Lizenz abgelehnt wird oder IsExpired wahr ist; bei einer bezahlten Lizenz bedeutet das, dass das Abonnementdatum überschritten ist und ein danach veröffentlichtes Paket abgelehnt wird — der aktuelle Build bleibt sauber.
Versions‑Upgrades
Eine Lizenz deckt ein Versionsfenster ab. Das Aktualisieren des NuGet‑Pakets auf einen Build neuer als dieses Fenster macht die Lizenz für diesen Build ungültig: IsVersionValid wird zu false und das Öffnen wird blockiert mit einem LicenseException (der Grund befindet sich in License.RejectionMessage) — bewusst sofortiges Scheitern, sodass ein veralteter oder unlizenzierter Build beim Deployment erkannt wird, anstatt stillschweigend Produktionsausgaben zu wasserzeichen. Erneuern Sie das Abonnement, ersetzen Sie das .lic und starten Sie die Anwendung neu, damit AddDoconut() die neue Lizenz lädt.
War diese Seite hilfreich?