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 inspeccionarlo todo desde el código. (Para cargar una licencia, vea 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* flags) |
| 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 lleva 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. Sólo una compilación lanzada después de ella es rechazada.
Dos consecuencias que vale la pena internalizar:
- Una licencia ausente 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).
- Sólo 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, de modo 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 Búsqueda y Anotación, y los complementos opcionales Convertidor, Dicom y Firmante, cada uno concedido por su licencia. El visor base no es una capacidad — es el requisito previo, expuesto como IsViewerLicensed:
var lic = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // non-TRIAL licencia presente AND que cubre la versión de esta compilaciónLa única puerta que usa todo el pipeline es IsCapabilityGranted:
var lic = Doconut.DoconutHost.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 legado 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 fecha (su ventana de suscripción se ignora; 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
Resuelva IDoconutLicenseService (namespace Doconut.Core.Interfaces) desde DoconutHost.Services. Es un singleton — la licencia se analiza una vez, en DoconutHost.Initialize:
| Miembro | Significado |
|---|---|
License | Instantánea completa DoconutLicenseInfo (abajo) |
IsTrial | Un archivo heredado tipo TRIAL (tratado como no licenciado — no es un derecho) |
IsTemporary / ExpiryNote / LicenseExpiry | Marcadores de licencia temporal |
IsExpired | Expirado 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.
// GET /Features - aplica feature-flag a tu UI desde la misma fuente de verdad que usa el SDK
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);
}Verificación de salud
Doconut registra una verificación de salud "doconut" que informa el estado de la licencia. Classic ASP.NET no tiene su propio endpoint de salud, así que expóngalo desde un controlador:
// GET /Health - Doconut registra una comprobación de salud "doconut" que informa el estado de la licencia:
// Saludable (válido), Degradado (prueba o sin archivo de licencia), No saludable (rechazado o expirado).
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");
}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 paga, eso significa que la fecha de suscripción ha pasado y un paquete lanzado después será rechazado — la compilación actual sigue renderizando correctamente. Consulte DoconutHost para los valores de estado.
Actualizaciones de versión
Una licencia cubre una ventana de versión. Actualizar el paquete NuGet a una compilación más nueva que esa ventana hace que la licencia sea inválida para esta compilación: IsVersionValid convierte 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 en el despliegue en lugar de marcar silenciosamente la salida de producción. Renueve la suscripción, reemplace el .lic en wwwroot, y recicle el grupo de aplicaciones para que DoconutHost.Initialize cargue la nueva licencia.
¿Fue útil esta página?