Configuración de Licencia

Where Doconut looks for your license file

Sin una licencia, Doconut aún renderiza documentos — cada página solo lleva una marca de agua de evaluación. Esta página cubre las cuatro formas de proporcionar una licencia y la precedencia exacta cuando se establece más de una.

Cuatro formas de proporcionar una licencia

Hay cuatro: tres fuentes explícitas en DoconutOptions — un flujo, contenido crudo o una ruta de archivo — más el descubrimiento automático cuando ninguna de ellas está configurada. Cuando se establece más de una, la precedencia es exacta:

LicenseStream supera a LicenseContent supera a LicensePath supera a auto-search.

Por ruta

LicensePath se pasa a File.Exists exactamente como se da. Una ruta relativa se resuelve contra el directorio de trabajo actual del proceso — no la carpeta de tu proyecto, y no la carpeta donde vive Program.cs. Si la ruta no se resuelve, Doconut no lanza una excepción y no recurre a la búsqueda automática — simplemente no carga ninguna licencia y el visor muestra marcas de agua. La búsqueda automática solo se ejecuta cuando ninguno de LicensePath, LicenseContent o LicenseStream está configurado. Los archivos de licencia por complemento en la misma carpeta (Doconut.Viewer.<Capability>.lic) se leen con ella, de modo que LicensePath y AddPlugin<...>() funcionan juntos cuando las licencias de los complementos están junto a la licencia base.

Prefiere una ruta absoluta (por ejemplo construida a partir de IWebHostEnvironment.WebRootPath o AppContext.BaseDirectory), o omite LicensePath por completo y confía en el descubrimiento automático a continuación.

csharp
builder.Services.AddDoconut(options =>
{
    options.LicensePath = Path.Combine(AppContext.BaseDirectory, "wwwroot", "Doconut.Viewer.lic");
});

Por flujo

LicenseStream se lee una vez al iniciar — útil cuando la licencia proviene de un almacén secreto en lugar de un archivo en disco.

csharp
// Prioridad: LicenseStream > LicenseContent > LicensePath > búsqueda automática.
builder.Services.AddDoconut(options =>
{
    options.LicenseStream = licenseStream;
});

Por contenido

LicenseContent acepta el texto de la licencia mismo — desde una variable de entorno, una base de datos o un gestor de secretos:

csharp
// XML de licencia desde una base de datos, variable de entorno o gestor de secretos —
// no hay archivo en disco. Solo superado por LicenseStream.
builder.Services.AddDoconut(options =>
{
    options.LicenseContent = Environment.GetEnvironmentVariable("DOCONUT_LICENSE") ?? "";
});

Descubrimiento automático

No configures ninguna de las tres fuentes explícitas, y Doconut buscará la licencia por sí mismo:

csharp
// No configure nada, y Doconut busca la licencia por sí mismo, solo en estas dos carpetas:
//   1. {CurrentDirectory}/wwwroot
//   2. {AppContext.BaseDirectory}/wwwroot   (wwwroot dentro de la carpeta de salida de compilación)
// Primero busca Doconut.lic; si falta, Doconut.Viewer.lic más cualquier
// archivos per-plugin Doconut.Viewer.<Capability>.lic.
builder.Services.AddDoconut();

Las carpetas de inspección, en orden, y los nombres de archivo buscados:

text
1. {CurrentDirectory}/wwwroot
2. {AppContext.BaseDirectory}/wwwroot

Filenames, in order (each one looked for in folder 1, then folder 2):
  Doconut.lic                          — legacy all-in-one license; if found, nothing else is read
  Doconut.Viewer.lic                   — base viewer license
  Doconut.Viewer.<Capability>.lic      — per-plugin licenses, read only when Doconut.Viewer.lic was found

No se lee nada fuera de una carpeta wwwroot: un .lic en la propia carpeta de salida, o en wwwroot/lib, se ignora.

Copia la licencia a tu carpeta de salida

Cuando el proceso no se ejecuta desde la carpeta del proyecto — una aplicación publicada, IIS, un contenedor, un ejecutor de pruebas — la primera inspección falla, y la segunda, {AppContext.BaseDirectory}/wwwroot, debe encontrar el archivo. Este objetivo de MSBuild copia las licencias allí en cada compilación:

xml
<Target Name="CopyLicensesToOutput" AfterTargets="Build">
  <ItemGroup>
    <DoconutLicenseFiles Include="$(MSBuildProjectDirectory)\wwwroot\*.lic" />
    <StaleOutputLicenses Include="$(OutDir)wwwroot\*.lic" />
  </ItemGroup>
  <!-- Elimine primero, de modo que renombrar o eliminar un .lic en wwwroot también lo elimine de la salida. -->
  <Delete Files="@(StaleOutputLicenses)" />
  <Copy SourceFiles="@(DoconutLicenseFiles)" DestinationFolder="$(OutDir)wwwroot" />
</Target>

El destino debe ser $(OutDir)wwwroot: un .lic copiado a la raíz de salida nunca es encontrado por la búsqueda automática. Los ejemplos LicensePath en esta página apuntan al mismo lugar.

Mantén los archivos .lic fuera del control de versiones — despléguelos junto a la aplicación, o inyecta la licencia a través de LicenseContent o LicenseStream desde tu almacén secreto.

Qué sucede sin una licencia

Una licencia faltante no lanza una excepción. AddDoconut() tiene éxito, la aplicación se inicia y el visor se ejecuta — pero cada página lleva una marca de agua de evaluación y no se concede ninguna capacidad opcional.

Un archivo de licencia que se encuentra pero es rechazado es diferente. Una firma inválida, manipulación, inclusión en lista negra, o una compilación fuera de la ventana de versiones de la licencia hace que OpenDocumentAsync lance LicenseException con License.RejectionMessage. Una licencia Temporal expirada continúa en modo con marca de agua. Una licencia paga cuya fecha de suscripción ha pasado sigue funcionando, limpia y con sus capacidades, en cada compilación lanzada antes de esa fecha.

Los complementos necesitan capacidades

Registrar un complemento sin la autorización correspondiente es diferente: para una licencia faltante, un archivo heredado TRIAL, o una licencia paga sin esa capacidad, AddDoconut() lanza InvalidOperationException, por lo que la aplicación no se inicia. Por ejemplo, registrar el complemento Converter sin una licencia que conceda Converter:

text
InvalidOperationException: The Converter plugin is registered via AddPlugin but no active
license grants Converter. Remove the AddPlugin<...>() call or install a license (or
trial/demo) that includes Converter.

El mensaje le indica la solución directamente: o elimine la llamada options.AddPlugin<...>() para ese complemento, o instale una licencia paga o una licencia Temporal/Demo (NFR) activa que conceda la capacidad. Las registraciones temporales pueden sobrevivir a su fecha de expiración para que una aplicación ya configurada pueda degradarse en tiempo de ejecución en lugar de fallar al reiniciarse; una vez expiradas, sus capacidades siguen revocadas.

Verificar la licencia cargada

Utilice IDoconutLicenseService, la misma fuente de verdad usada por el SDK, para exponer un endpoint de diagnóstico autenticado o para controlar banderas de características. No devuelva el contenido de la licencia ni sus claves.

csharp
app.MapGet("/api/doconut/license", (IDoconutLicenseService license) => Results.Ok(new
{
    viewer = license.IsViewerLicensed || license.IsTemporary,
    temporary = license.IsTemporary,
    search = license.IsCapabilityGranted(LicenseCapability.Search),
    annotation = license.IsCapabilityGranted(LicenseCapability.Annotation),
    converter = license.HasConverter,
    dicom = license.HasDicom
}));

La licencia se lee durante el registro AddDoconut(). ResetLicense es actualmente una propiedad de compatibilidad sin una ruta de recarga activa, por lo que reemplazar un archivo de licencia requiere reiniciar la aplicación.

Matriz de solución de problemas

SíntomaCausa probableVerificar
El visor funciona pero cada página tiene marca de aguaNo se cargó ninguna licencia, o la licencia Temporal ha expiradoResuelva IDoconutLicenseService; verifique el directorio de salida y el directorio de trabajo del proceso
AddDoconut() lanza para un complementoLa licencia no concede esa capacidad del complementoVerifique IsCapabilityGranted(...) y elimine las registraciones que no compró
Una ruta relativa configurada funciona localmente pero no en IIS/contenedorEl directorio de trabajo del proceso cambióUtilice AppContext.BaseDirectory o una ruta absoluta
El archivo .lic reemplazado no tiene efectoEl servicio de licencia singleton ya estaba creadoReinicie la aplicación
OpenDocumentAsync lanza LicenseExceptionFirma, dominio, ventana de versión, lista negra, o puerta de tiempo de ejecución del complemento rechazó la licenciaLea el mensaje de excepción/rechazo sin exponerlo a clientes no confiables

Próximos pasos

  • Licencias — capacidades, niveles de licencia y verificar lo que se cargó en tiempo de ejecución.
  • Solución de problemas — marcas de agua, licencias rechazadas y errores de capacidad.

¿Fue útil esta página?