Licencias

Capacidades, niveles de licencia y el servicio de licencias

Esta página es la referencia en tiempo de ejecución de cómo una licencia define el comportamiento de Doconut: lo que permite cada estado de licencia, cómo se conceden las capacidades y cómo inspeccionar todo desde el código. (Para cargar una licencia, vea Empezando → Configuración de Licencia.)

Estados de licencia y lo que hacen

Estado¿Abre documentos?Marca de aguaCapacidades
Licencia completa (de pago) (esta compilación se lanzó antes de su fecha de suscripción)SíNingunaLas que se compraron (Has* banderas)
Licencia temporal (Desarrollador/NFR — la licencia de evaluación, antes de su fecha de expiración)SíNinguna en el visor base; la salida del plugin tiene marca de aguaTodas — concesión total (el embudo de evaluación)
Licencia temporal expirada (pasada su fecha LicenseExpiry)SíMarca de agua de evaluaciónNinguna concedida
Sin archivo de licenciaSíMarca de agua de evaluaciónNinguna concedida
Encontrada pero rechazada (firma inválida, manipulada, en lista negra, o una compilación lanzada después de la fecha de suscripción de la licencia)No — LicenseException en cada apertura——

Una licencia de pago cuya fecha de suscripción ha pasado sigue funcionando — limpia, con sus capacidades — en cada compilación lanzada antes de esa fecha. Solo una compilación lanzada después es rechazada.

Dos consecuencias que vale la pena internalizar:

  • Una licencia faltante no es una licencia temporal. Sin archivo de licencia, las páginas se renderizan con marca de agua y ninguna capacidad (búsqueda, anotación, complementos) está activa. La experiencia completa, sin marca de agua, requiere una licencia temporal (obtener una).
  • Solo una licencia rechazada bloquea la apertura. Una licencia Temporal expirada mantiene la aplicación en ejecución con la marca de agua de evaluación, y una licencia de pago pasada su fecha de suscripción sigue renderizando limpio en las compilaciones que cubre; pero desplegar una compilación lanzada después de la fecha de suscripción de la licencia es rechazado y falla rápidamente con un LicenseException, por lo que lo detectas en el despliegue — no enviando silenciosamente salida con marca de agua. Esa excepción (de OpenDocumentAsync) lleva la razón de License.RejectionMessage.

Capacidades

Doconut controla la funcionalidad opcional mediante capacidad. Cubre las funciones integradas Search y Annotation y los complementos opcionales Converter, Dicom y Signer, cada uno concedido por su licencia. El visor base no es una capacidad — es el requisito previo, expuesto como IsViewerLicensed:

csharp
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // licencia non-TRIAL presente Y que cubre la versión de esta compilación

La única puerta que usa todo el pipeline es IsCapabilityGranted:

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

Su lógica, literalmente de la implementación: una licencia Temporal activa (no expirada) concede todas las capacidades — incluidas aquellas que aún no tienen una bandera de compra dedicada; una licencia comprada real concede exactamente sus banderas Has* y tiene denegación por defecto para cualquier cosa no mapeada. (Un archivo heredado de tipo TRIAL no es un derecho — se trata como sin licencia: con marca de agua, nada concedido.)

Licencias temporales

Las licencias temporales (Desarrollador/NFR) están marcadas con una etiqueta ExpiryNote y llevan una fecha de expiración rígida:

MiembroSignificado
IsTemporaryUna etiqueta ExpiryNote está presente (la detección se basa en la presencia de la etiqueta — nunca coincida con el texto de la nota, es dinámico)
ExpiryNoteTexto informativo incrustado en la licencia
LicenseExpiryLa fecha de expiración rígida (DateTime?)

La semántica de expiración difiere por nivel: una licencia temporal expira en su LicenseExpiry solo la fecha (se ignora su ventana de suscripción; una licencia temporal sin la fecha se trata como expirada, a prueba de fallos). Todas las demás licencias expiran en su fecha de ventana de suscripción/actualización; para una licencia de pago, IsExpired solo informa que esta fecha ha pasado — las compilaciones lanzadas antes permanecen limpias y conservan sus capacidades.

Referencia de IDoconutLicenseService

Inyecte IDoconutLicenseService (espacio de nombres Doconut.Core.Interfaces; registrado como singleton — la licencia se analiza una vez al iniciar):

MiembroSignificado
LicenseInstantánea completa DoconutLicenseInfo (abajo)
IsTrialUn archivo heredado de tipo TRIAL (tratado como sin licencia — no es un derecho)
IsTemporary / ExpiryNote / LicenseExpiryMarcadores de licencia temporal
IsExpiredExpirada según las reglas de nivel anteriores
IsVersionValidEsta compilación está dentro de la ventana de soporte de la licencia
IsViewerLicensedArchivo no-TRIAL encontrado y versión cubierta — requisito base
IsCapabilityGranted(cap)La única puerta de capacidad
HasSearch HasAnnotation HasEditor HasConverter HasDicom HasDocumentTools HasSigner HasRedactor HasComparer HasForms HasProtector HasCompressorUna bandera por capacidad: comprada por una licencia que cubre esta compilación, o concedida por una licencia Temporal activa. IsCapabilityGranted responde la misma pregunta por capacidad
IsValidForDomain(host)Cobertura de host; las licencias V4 usan el comodín *.*
LicenseRejectionReasonNo vacío ⇒ la apertura se bloquea con este mensaje

DoconutLicenseInfo expone la instantánea amigable para la visualización en paneles de administración: Owner, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, las banderas Has*, los campos de licencia temporal, y RejectionMessage.

csharp
// Feature-flag tu UI desde la misma fuente de verdad que usa el 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,
}));

Verificación de salud

AddDoconut() registra una verificación de salud "doconut" que informa el estado de licencia/expiración a través del mecanismo estándar de ASP.NET Core:

csharp
app.MapHealthChecks("/health");

Integrelo en su monitoreo y una suscripción que expira se convierte en una alerta en lugar de un ticket de soporte. La verificación informa Unhealthy cuando la licencia es rechazada o IsExpired es verdadero; para una licencia de pago, eso significa que la fecha de suscripción ha pasado y un paquete lanzado después será rechazado — la compilación actual sigue renderizando limpio.

Actualizaciones de versión

Una licencia cubre una ventana de versión. Actualizar el paquete NuGet a una compilación más reciente que esa ventana invalida la licencia para esta compilación: IsVersionValid se convierte en false y la apertura se bloquea con un LicenseException (la razón está en License.RejectionMessage) — falla rápidamente a propósito, de modo que una compilación obsoleta o sin licencia se detecta al desplegarse en lugar de marcar silenciosamente la salida de producción. Renueve la suscripción, reemplace el .lic y reinicie la aplicación para que AddDoconut() cargue la nueva licencia.

¿Fue útil esta página?