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 aguaCapacidades
Licencia completa (de pago) (esta compilación se lanzó antes de su fecha de suscripción)SíNingunaLas 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 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. 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 (de OpenDocumentAsync) lleva la razón de License.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:

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

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

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

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

MiembroSignificado
LicenseInstantánea completa DoconutLicenseInfo (abajo)
IsTrialUn archivo heredado tipo TRIAL (tratado como no licenciado — no es un derecho)
IsTemporary / ExpiryNote / LicenseExpiryMarcadores de licencia temporal
IsExpiredExpirado 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
// 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:

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