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

ÉtatOuvre les documents ?FiligraneCapacités
Licence complète (payée) (cette version a été publiée avant sa date d'abonnement)OuiAucunCelles achetées (Has* flags)
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 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 de OpenDocumentAsync) contient la raison provenant de License.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 :

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

Le seul point de contrôle que l'ensemble du pipeline utilise est IsCapabilityGranted :

csharp
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 :

MembreSignification
IsTemporaryUne 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)
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). 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 :

MembreSignification
LicenseCapture complète de DoconutLicenseInfo (ci‑dessous)
IsTrialUn fichier hérité de type ESSAI (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 d’accès 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
// 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 :

csharp
// 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 ?