Licence

Fonctionnalités, niveaux de licence et le service de licence

Cette page est la référence d'exécution pour la façon dont une licence façonne le comportement de Doconut : ce que chaque état de licence autorise, comment les fonctionnalités sont accordées, et comment inspecter tout cela depuis le code. (Pour chargement d'une licence, voir Démarrage → Configuration de la licence.)

États de licence et ce qu'ils font

ÉtatOuvre les documents ?FiligraneFonctionnalités
Licence complète (payée) (cette version a été publiée avant sa date d'abonnement)OuiAucunCelles achetées (Has* drapeaux)
Licence temporaire (Développeur/NFR — la licence d'évaluation, avant sa date d'expiration)OuiAucun sur le visualiseur de base ; la sortie du plugin est filigranéeToutes — attribution globale (l'entonnoir d'évaluation)
Licence temporaire expirée (après sa date LicenseExpiry)OuiFiligrane d'évaluationAucune accordée
Aucun fichier de licenceOuiFiligrane d'évaluationAucune accordée
Trouvé mais rejeté (signature invalide, altéré, sur liste noire, ou une version publiée après la date d'abonnement de la licence)Non — LicenseException à chaque ouverture——

Une licence payée dont la date d'abonnement est passée continue de fonctionner — propre, avec ses fonctionnalités — sur chaque version publiée avant cette date. Seule une version publiée après celle-ci est rejetée.

Deux conséquences à retenir :

  • Une licence manquante n'est pas une licence temporaire. Sans fichier de licence, les pages s'affichent avec un filigrane et aucune fonctionnalité (recherche, annotation, plugins) n'est active. L'expérience complète, sans filigrane, nécessite une Licence temporaire (obtenez‑en une).
  • Seule une licence rejetée bloque l'ouverture. Une licence temporaire expirée maintient l'application en fonctionnement avec le filigrane d'évaluation, et une licence payée dont la date d'abonnement est passée continue d'afficher proprement les versions qu'elle couvre ; mais le déploiement d'une version publiée après la date d'abonnement de la licence est rejeté et échoue rapidement avec un LicenseException, ainsi vous le détectez lors du déploiement — pas en diffusant silencieusement une sortie filigranée. Cette exception (provenant de OpenDocumentAsync) porte la raison depuis License.RejectionMessage.

Fonctionnalités

Doconut contrôle les fonctionnalités optionnelles par capacité. Il couvre les fonctionnalités intégrées Recherche et Annotation ainsi que les plugins optionnels Convertisseur, Dicom et Signer, chacune accordée par votre licence. Le visualiseur de base n'est pas une capacité — c'est le prérequis, exposé comme IsViewerLicensed :

csharp
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // licence non-TRIAL présente ET couvrant la version de cette build

Le seul point de contrôle que toute la chaîne utilise est IsCapabilityGranted :

csharp
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool searchGranted = lic.IsCapabilityGranted(LicenseCapability.Search);

Sa logique, mot pour mot de l'implémentation : une licence Temporaire active (non expirée) accorde toute capacité — y compris les capacités qui n'ont pas encore de drapeau d'achat dédié ; une vraie licence achetée accorde exactement ses drapeaux Has* et est défaut‑refus pour tout ce qui n'est pas mappé. (Un fichier de type TRIAL hérité n'est pas un droit — il est traité comme non licencié : filigrané, rien n'est accordé.)

Licences temporaires

Les licences temporaires (Développeur/NFR) sont marquées par une balise ExpiryNote et comportent une date d'expiration stricte :

MembreSignification
IsTemporaryUne balise ExpiryNote est présente (la détection se fait par présence de balise — jamais en comparant le texte de la note, c'est dynamique)
ExpiryNoteTexte informatif intégré dans la licence
LicenseExpiryLa date d'expiration stricte (DateTime?)

La sémantique d'expiration varie selon le niveau : une licence temporaire expire à sa LicenseExpiry date uniquement (sa fenêtre d'abonnement est ignorée ; une licence temporaire sans date est considérée comme expirée, en mode sécuritaire). Toutes les autres licences expirent à la date de leur fenêtre d'abonnement/mise à jour ; pour une licence payée, IsExpired indique simplement que cette date est passée — les versions publiées avant restent propres et conservent leurs fonctionnalités.

Référence IDoconutLicenseService

Injectez IDoconutLicenseService (espace de noms Doconut.Core.Interfaces ; enregistré en tant que singleton — la licence est analysée une fois au démarrage) :

MembreSignification
LicenseCapture complète DoconutLicenseInfo (ci‑dessous)
IsTrialUn fichier de type TRIAL hérité (traité comme non licencié — pas un droit)
IsTemporary / ExpiryNote / LicenseExpiryMarqueurs de licence temporaire
IsExpiredExpiré selon les règles de niveau ci‑dessus
IsVersionValidCette version se situe dans la fenêtre de support de la licence
IsViewerLicensedFichier non-TRIAL trouvé et version couverte — prérequis de base
IsCapabilityGranted(cap)Le seul point de contrôle de capacité
HasSearch HasAnnotation HasEditor HasConverter HasDicom HasDocumentTools HasSigner HasRedactor HasComparer HasForms HasProtector HasCompressorUn drapeau par capacité : acheté par une licence qui couvre cette version, ou accordé par une licence Temporaire active. IsCapabilityGranted répond à la même question par capacité
IsValidForDomain(host)Couverture d'hôte ; les licences V4 utilisent le caractère générique *.*
LicenseRejectionReasonNon‑vide ⇒ l'ouverture est bloquée avec ce message

DoconutLicenseInfo expose la capture conviviale pour les panneaux d'administration : Owner, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, les drapeaux Has*, les champs de licence temporaire, et RejectionMessage.

csharp
// Feature-flag votre UI depuis la même source de vérité utilisée par le SDK
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,
}));

Vérification de santé

AddDoconut() enregistre une vérification de santé "doconut" qui rapporte l'état de licence/expiration via le mécanisme standard ASP.NET Core :

csharp
app.MapHealthChecks("/health");

Intégrez‑la à votre surveillance et un abonnement expirant devient une alerte plutôt qu'un ticket de support. La vérification rapporte Unhealthy lorsque la licence est rejetée ou que IsExpired est vrai ; pour une licence payée, cela signifie que la date d'abonnement est passée et qu'un paquet publié après sera rejeté — la version actuelle continue d'afficher proprement.

Mises à jour de version

Une licence couvre une fenêtre de version. Mettre à jour le paquet NuGet vers une version plus récente que cette fenêtre rend la licence invalide pour cette version : IsVersionValid devient false et l'ouverture est bloquée avec un LicenseException (la raison se trouve dans License.RejectionMessage) — échec rapide délibéré, afin qu'une version obsolète ou non licenciée soit détectée lors du déploiement plutôt que de filigraner silencieusement la production. Renouvelez l'abonnement, remplacez le .lic, et redémarrez l'application afin que AddDoconut() charge la nouvelle licence.

Cette page était-elle utile ?