Licence
Fonctionnalités, niveaux de licence et le service de licence
Cette page est la référence d'exécution sur 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 tout inspecter depuis le code. (Pour charger une licence, voir Démarrage → Configuration de la licence.)
États de licence et ce qu'ils font
| État | Ouvre les documents ? | Filigrane | Fonctionnalités |
|---|---|---|---|
| Licence complète (payée) (cette version a été publiée avant sa date d'abonnement) | Oui | Aucun | Celles achetées (Has* flags) |
| Licence temporaire (Développeur/NFR — la licence d'évaluation, avant sa date d'expiration) | Oui | Aucun sur le visualiseur de base ; la sortie du plugin est filigranée | Toutes — attribution globale (l'entonnoir d'évaluation) |
Licence temporaire expirée (après sa date LicenseExpiry) | Oui | Filigrane d'évaluation | Aucune accordée |
| Aucun fichier de licence | Oui | Filigrane d'évaluation | Aucune 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 (obtenir 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 de rendre propre les versions qu'elle couvre ; mais déployer 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 — et non en diffusant silencieusement une sortie filigranée. Cette exception (deOpenDocumentAsync) porte la raison provenant deLicense.RejectionMessage.
Fonctionnalités
Doconut contrôle la fonctionnalité optionnelle par capacité. Elle 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 :
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // licence non-TRIAL présente ET couvrant la version du buildLe seul point de contrôle utilisé par l'ensemble du pipeline est IsCapabilityGranted :
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 toutes les capacités — y compris celles qui n'ont pas encore de drapeau d'achat dédié ; une vraie licence achetée accorde exactement ses drapeaux Has* et est refus par défaut 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é, aucune capacité accordée.)
Licences temporaires
Les licences temporaires (Développeur/NFR) sont marquées par une balise ExpiryNote et comportent une date d'expiration stricte :
| Membre | Signification |
|---|---|
IsTemporary | Une 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) |
ExpiryNote | Texte informatif intégré dans la licence |
LicenseExpiry | La date d'expiration stricte (DateTime?) |
La sémantique d'expiration diffère 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 à leur date de fenêtre d'abonnement/mise à jour ; pour une licence payée, IsExpired indique seulement que cette date est passée — les versions publiées avant restent propres et conservent leurs capacités.
Référence IDoconutLicenseService
Injectez IDoconutLicenseService (espace de noms Doconut.Core.Interfaces ; enregistré comme singleton — la licence est analysée une fois au démarrage) :
| Membre | Signification |
|---|---|
License | Instantané complet DoconutLicenseInfo (ci‑dessous) |
IsTrial | Un fichier de type TRIAL hérité (traité comme non licencié — pas un droit) |
IsTemporary / ExpiryNote / LicenseExpiry | Marqueurs de licence temporaire |
IsExpired | Expiré selon les règles de niveau ci‑dessus |
IsVersionValid | Cette version se situe dans la fenêtre de support de la licence |
IsViewerLicensed | Fichier 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 HasCompressor | Un 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 *.* |
LicenseRejectionReason | Non‑vide ⇒ l'ouverture est bloquée avec ce message |
DoconutLicenseInfo expose le snapshot convivial pour les panneaux d'administration : Owner, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, les drapeaux Has*, les champs de licence temporaire, et RejectionMessage.
// Feature-flag votre UI à partir de 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 :
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 package publié après sera rejeté — la version actuelle continue de rendre propre.
Mises à jour de version
Une licence couvre une fenêtre de version. Mettre à jour le package NuGet vers une version plus récente que cette fenêtre rend la licence invalide pour cette version : IsVersionValid transforme 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 ?