Licence
Capacité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 capacités sont accordées, et comment inspecter tout cela depuis le code. (Pour charger une licence, voir Configuration de licence.)
États de licence et leurs fonctions
| État | Ouvre les documents ? | Filigrane | Capacité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 capacité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 capacité (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 dépassée continue de s'afficher proprement sur 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 deOpenDocumentAsync) contient la raison provenant deLicense.RejectionMessage.
Capacité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, chacun accordé par votre licence. Le visualiseur de base n'est pas une capacité — c'est le prérequis, exposé comme IsViewerLicensed :
var lic = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // licence non-TRIAL présente ET couvrant la version du buildLe seul point de contrôle que l'ensemble du pipeline utilise est IsCapabilityGranted :
var lic = Doconut.DoconutHost.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 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é, 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 la présence de la balise — ne jamais correspondre au 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 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). Toute autre licence expire à sa 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
Résolvez IDoconutLicenseService (espace de noms Doconut.Core.Interfaces) depuis DoconutHost.Services. C’est un singleton — la licence est analysée une fois, dans DoconutHost.Initialize :
| Membre | Signification |
|---|---|
License | Capture complète de DoconutLicenseInfo (ci‑dessous) |
IsTrial | Un fichier hérité de type ESSAI (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 d’accès 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 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.
// GET /Features - feature-flag votre UI depuis la même source de vérité que le SDK utilise
public ActionResult Index()
{
var lic = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();
return Json(new
{
viewer = lic.IsViewerLicensed || lic.IsTemporary,
search = lic.IsCapabilityGranted(LicenseCapability.Search),
annotation = lic.IsCapabilityGranted(LicenseCapability.Annotation),
conversion = lic.HasConverter,
dicom = lic.HasDicom,
}, JsonRequestBehavior.AllowGet);
}Vérification de santé
Doconut enregistre une vérification de santé "doconut" qui rapporte l’état de la licence. Classic ASP.NET n’a pas de point de terminaison de santé propre, donc exposez‑la depuis un contrôleur :
// GET /Health - Doconut enregistre un contrôle de santé "doconut" qui rapporte l'état de la licence :
// Sain (valide), Dégradé (essai ou aucun fichier de licence), Non sain (rejeté ou expiré).
public async Task<ActionResult> Index()
{
var health = Doconut.DoconutHost.Services.GetRequiredService<HealthCheckService>();
HealthReport report = await health.CheckHealthAsync();
Response.StatusCode = report.Status == HealthStatus.Unhealthy ? 503 : 200;
return Content(report.Status.ToString(), "text/plain");
}Intégrez‑la à votre surveillance et un abonnement expiré devient une alerte plutôt qu’un ticket de support. La vérification signale Unhealthy lorsque la licence est rejetée ou que IsExpired est vrai ; pour une licence payante, cela signifie que la date d’abonnement est passée et qu’un paquet publié après sera rejeté — la version actuelle continue de s’afficher correctement. Voir DoconutHost pour les valeurs d’état.
Mises à jour de version
Une licence couvre une fenêtre de version. Mettre à jour le paquet NuGet vers une version postérieure à cette fenêtre rend la licence invalide pour cette version : IsVersionValid se transforme en false et l’ouverture est bloquée avec un(e) 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 d’ajouter silencieusement un filigrane à la production. Renouvelez l’abonnement, remplacez le .lic dans wwwroot, et recyclez le pool d’applications afin que DoconutHost.Initialize charge la nouvelle licence.
Cette page était-elle utile ?