Licensiering
Funktioner, licenstier och licenstjänsten
Denna sida är referensen vid körning för hur en licens formar Doconut:s beteende: vad varje licenstillstånd tillåter, hur funktioner beviljas, och hur man inspekterar allt detta från kod. (För laddning av en licens, se Kom igång → Licensinställning.)
Licenstillstånd och vad de gör
| Tillstånd | Öppnar dokument? | Vattenstämpel | Funktioner |
|---|---|---|---|
| Full (betald) licens (denna build släpptes före dess prenumerationsdatum) | Ja | Ingen | De som köpts (Has* flaggor) |
| Tillfällig licens (Developer/NFR — utvärderingslicensen, före dess utgångsdatum) | Ja | Ingen i basvisaren; pluginutdata är vattenstämplad | Alla — generell beviljning (utvärderingsflödet) |
Utgången tillfällig licens (förbi dess LicenseExpiry datum) | Ja | Utvärderingsvattenstämpel | Ingen beviljad |
| Ingen licensfil alls | Ja | Utvärderingsvattenstämpel | Ingen beviljad |
| Hittad men avvisad (ogiltig signatur, manipulerad, svartlistad, eller en build släppt efter licensens prenumerationsdatum) | Nej — LicenseException vid varje öppning | — | — |
En betald licens vars prenumerationsdatum har passerat fortsätter att fungera — ren, med sina funktioner — på varje build som släppts före det datumet. Endast en build som släpps efter den avvisas.
Två konsekvenser som är värda att internalisera:
- En saknad licens är inte en tillfällig licens. Utan licensfil renderas sidor med vattenstämpel och ingen funktion (sökning, annotering, plugins) är aktiv. Den fullt utrustade, vattenstämpelfria upplevelsen kräver en faktisk Tillfällig licens (skaffa en).
- Endast en avvisad licens blockerar öppning. En utgången Tillfällig licens låter appen köra med utvärderingsvattenstämpel, och en betald licens som passerat sitt prenumerationsdatum fortsätter att rendera rent på de builds den täcker; men att distribuera en build som släppts efter licensens prenumerationsdatum avvisas och misslyckas snabbt med en
LicenseException, så du fångar det vid distribution — inte genom att tyst skicka vattenstämplad output. Det undantaget (frånOpenDocumentAsync) innehåller orsaken frånLicense.RejectionMessage.
Funktioner
Doconut styr valfri funktionalitet via funktion. Den omfattar de inbyggda Sök- och Annotering-funktionerna samt de valfria Converter, Dicom och Signer-plugins, var och en beviljad av din licens. Basvisaren är inte en funktion — den är förutsättningen, framträdd som IsViewerLicensed:
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // non-TRIAL licens närvarande OCH täcker den här byggens versionDen enda grind som hela pipeline använder är IsCapabilityGranted:
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool searchGranted = lic.IsCapabilityGranted(LicenseCapability.Search);Dess logik, ordagrant från implementationen: en aktiv (ej utgången) Tillfällig licens beviljar varje funktion — inklusive funktioner som ännu inte har en dedikerad köpsflagga; en verklig köpt licens beviljar exakt sina Has* flaggor och är default‑deny för allt som inte är mappat. (En äldre TRIAL‑typ fil är inte en rättighet — den behandlas som olicensierad: vattenstämplad, inget beviljat.)
Tillfälliga licenser
Tillfälliga (Developer/NFR) licenser markeras med en ExpiryNote‑tagg och har ett fast utgångsdatum:
| Medlem | Betydelse |
|---|---|
IsTemporary | En ExpiryNote‑tagg är närvarande (detektering sker via tagg‑närvaro — matcha aldrig notens text, den är dynamisk) |
ExpiryNote | Informativ text inbäddad i licensen |
LicenseExpiry | Det fasta utgångsdatumet (DateTime?) |
Utgångssemantiken skiljer sig per nivå: en tillfällig licens går ut på sitt LicenseExpiry endast datum (dess prenumerationsfönster ignoreras; en tillfällig licens utan datum behandlas som utgången, felsäker). Alla andra licenser går ut på sitt prenumerations-/uppdateringsfönster datum; för en betald licens rapporterar IsExpired endast att detta datum har passerat — builds som släppts före det förblir rena och behåller sina funktioner.
IDoconutLicenseService‑referens
Injectera IDoconutLicenseService (namnrymd Doconut.Core.Interfaces; registrerad som en singleton — licensen parsas en gång vid start):
| Medlem | Betydelse |
|---|---|
License | Fullt DoconutLicenseInfo‑ögonblicksbild (nedan) |
IsTrial | En äldre TRIAL‑typ fil (behandlad som olicensierad — inte en rättighet) |
IsTemporary / ExpiryNote / LicenseExpiry | Tillfällig‑licens‑markörer |
IsExpired | Utgången enligt tier‑reglerna ovan |
IsVersionValid | Denna build faller inom licensens supportfönster |
IsViewerLicensed | Icke-TRIAL fil hittad och version täckt — grundförutsättning |
IsCapabilityGranted(cap) | Den enda funktionsgrinden |
HasSearch HasAnnotation HasEditor HasConverter HasDicom HasDocumentTools HasSigner HasRedactor HasComparer HasForms HasProtector HasCompressor | En flagga per funktion: köpt av en licens som täcker denna build, eller beviljad av en aktiv Tillfällig licens. IsCapabilityGranted svarar på samma fråga per funktion |
IsValidForDomain(host) | Värdtäckning; V4‑licenser använder wildcard‑*.* |
LicenseRejectionReason | Ej tom ⇒ öppning blockeras med detta meddelande |
DoconutLicenseInfo exponerar den display‑vänliga ögonblicksbilden för admin‑paneler: Owner, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, Has*‑flaggorna, de tillfälliga licens‑fälten, och RejectionMessage.
// Feature-flag ditt UI från samma sanningskälla som SDK:n använder
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,
}));Hälsokontroll
AddDoconut() registrerar en "doconut" hälsokontroll som rapporterar licens-/utgångstillstånd via den standard ASP.NET Core‑mekanismen:
app.MapHealthChecks("/health");Koppla in den i din övervakning så blir en utgående prenumeration ett larm istället för ett supportärende. Kontrollen rapporterar Unhealthy när licensen avvisas eller IsExpired är sann; för en betald licens betyder det att prenumerationsdatumet har passerat och ett paket som släpps efter det kommer att avvisas — den aktuella builden fortsätter rendera rent.
Versionsuppgraderingar
En licens täcker ett versionsfönster. Att uppdatera NuGet‑paketet till en build nyare än det fönstret gör licensen ogiltig för denna build: IsVersionValid blir false och öppning blockeras med en LicenseException (orsaken finns i License.RejectionMessage) — avsiktligt fail‑fast, så en föråldrad eller olicensierad build fångas vid distribution snarare än att tyst vattenstämpla produktionsoutput. Förnya prenumerationen, ersätt .lic, och starta om applikationen så att AddDoconut() laddar den nya licensen.
Var den här sidan hjälpsam?