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 agua | Capacidades |
|---|---|---|---|
| Licencia completa (de pago) (esta compilación se lanzó antes de su fecha de suscripción) | Sí | Ninguna | Las 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 agua | Todas — concesión total (el embudo de evaluación) |
Licencia temporal expirada (pasada su fecha LicenseExpiry) | Sí | Marca de agua de evaluación | Ninguna concedida |
| Sin archivo de licencia | Sí | Marca de agua de evaluación | Ninguna 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 (deOpenDocumentAsync) lleva la razón deLicense.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:
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // licencia non-TRIAL presente Y que cubre la versión de esta compilaciónLa única puerta que usa todo el pipeline es IsCapabilityGranted:
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:
| Miembro | Significado |
|---|---|
IsTemporary | Una 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) |
ExpiryNote | Texto informativo incrustado en la licencia |
LicenseExpiry | La 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):
| Miembro | Significado |
|---|---|
License | Instantánea completa DoconutLicenseInfo (abajo) |
IsTrial | Un archivo heredado de tipo TRIAL (tratado como sin licencia — no es un derecho) |
IsTemporary / ExpiryNote / LicenseExpiry | Marcadores de licencia temporal |
IsExpired | Expirada según las reglas de nivel anteriores |
IsVersionValid | Esta compilación está dentro de la ventana de soporte de la licencia |
IsViewerLicensed | Archivo 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 HasCompressor | Una 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 *.* |
LicenseRejectionReason | No 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.
// 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:
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?