Lizenzierung

Funktionen, Lizenzstufen und der Lizenzdienst

Diese Seite ist die Laufzeit‑Referenz dafür, wie eine Lizenz das Verhalten von Doconut beeinflusst: 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.)

Lizenzzustände und ihre Funktionen

ZustandÖffnet Dokumente?WasserzeichenFunktionen
Vollständige (bezahlte) Lizenz (dieser Build wurde vor seinem Abonnementdatum veröffentlicht)JaKeinesDie erworbenen (Has*-Flags)
Temporäre Lizenz (Entwickler/NFR — die Evaluierungslizenz, vor ihrem Ablaufdatum)JaKeines im Basisviewer; Plugin-Ausgabe ist mit Wasserzeichen versehenAlle — pauschale Erlaubnis (der Evaluierungs‑Funnel)
Abgelaufene temporäre Lizenz (nach ihrem LicenseExpiry-Datum)JaEvaluierungswasserzeichenKeine vergeben
Keine Lizenzdatei vorhandenJaEvaluierungswasserzeichenKeine vergeben
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 Build, der danach veröffentlicht wird, 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 ausgestattete, wasserzeichenfreie Erlebnis erfordert eine tatsächliche Temporäre Lizenz (einen erhalten).
  • Nur eine abgelehnte Lizenz blockiert das Öffnen. Eine abgelaufene Temporäre Lizenz lässt die Anwendung mit dem Evaluierungswasserzeichen weiterlaufen, und eine bezahlte Lizenz nach ihrem Abonnementdatum rendert weiterhin sauber auf den Builds, die sie abdeckt; aber das Bereitstellen eines Builds, der nach dem Abonnementdatum der Lizenz veröffentlicht wurde, wird abgelehnt und bricht schnell ab mit einem LicenseException, sodass Sie es beim Deployment erkennen — nicht durch stilles Ausliefern von wasserzeichenbehafteten Ausgaben. Diese Ausnahme (von OpenDocumentAsync) enthält den Grund von License.RejectionMessage.

Funktionen

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:

csharp
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // non-TRIAL Lizenz vorhanden UND deckt die Version dieses Builds ab

Das einzige Gate, das die gesamte Pipeline verwendet, ist IsCapabilityGranted:

csharp
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 spezielles Kauf‑Flag existiert; eine tatsächlich gekaufte Lizenz gewährt exakt ihre Has*‑Flags und ist standardmäßig ablehnend für alles, was nicht zugeordnet ist. (Eine alte TRIAL‑Datei ist keine Berechtigung — sie wird als unlizenziert behandelt: wasserzeichenbehaftet, nichts gewährt.)

Temporäre Lizenzen

Temporäre (Entwickler/NFR) Lizenzen werden durch ein ExpiryNote-Tag gekennzeichnet und besitzen ein festes Ablaufdatum:

MitgliedBedeutung
IsTemporaryEin ExpiryNote-Tag ist vorhanden (Erkennung erfolgt durch Vorhandensein des Tags — nie anhand des Textes der Notiz, es ist dynamisch)
ExpiryNoteInformationstext, der in die Lizenz eingebettet ist
LicenseExpiryDas 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 Funktionen.

IDoconutLicenseService-Referenz

Inject IDoconutLicenseService (Namespace Doconut.Core.Interfaces; als Singleton registriert — die Lizenz wird beim Start einmal geparst):

MitgliedBedeutung
LicenseVollständiger DoconutLicenseInfo-Snapshot (unten)
IsTrialEine alte TRIAL‑Datei (als unlizenziert behandelt — keine Berechtigung)
IsTemporary / ExpiryNote / LicenseExpiryTemporäre Lizenz‑Marker
IsExpiredAbgelaufen gemäß den obigen Stufenregeln
IsVersionValidDieser Build liegt innerhalb des Support‑Fensters der Lizenz
IsViewerLicensedNicht-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 HasCompressorEin Flag pro Fähigkeit: erworben durch eine Lizenz, die diesen Build abdeckt, oder gewährt durch eine aktive Temporäre Lizenz. IsCapabilityGranted beantwortet dieselbe Frage nach Fähigkeit
IsValidForDomain(host)Host‑Abdeckung; V4‑Lizenzen verwenden das Platzhalter‑Symbol *.*
LicenseRejectionReasonNicht leer ⇒ Öffnen wird mit dieser Meldung blockiert

DoconutLicenseInfo stellt den benutzerfreundlichen Snapshot für Admin‑Panels bereit: Owner, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, die Has*‑Flags, die Felder der temporären Lizenz und RejectionMessage.

csharp
// 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"‑Health‑Check, der den Lizenz‑/Ablauf‑Zustand über den Standard‑ASP.NET‑Core‑Mechanismus meldet:

csharp
app.MapHealthChecks("/health");

Binden Sie ihn in Ihr Monitoring ein und ein auslaufendes Abonnement wird zu einem Alarm 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 wurde und ein nach diesem Datum veröffentlichtes Paket abgelehnt wird — der aktuelle Build bleibt sauber.

Versionsupgrades

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 steht in License.RejectionMessage) — bewusst schnell fehlschlagen, 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?